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PREFACE 


The DIGITAL XVM (XVM) MACRO Assembler program, MACRO XVM, provides the 
user with the symbolic programming capabilities of an assembler plus 
the added compiler capabilities of a many-for-one macro instruction 
generator. This manual describes the syntax, application and operations 
performed by the MACRO XVM assembler. 

In the preparation of this manual it was assumed that the reader was 
familiar with the basic XVM symbolic instruction set. 

The MACRO XVM program may be operated in: 

a. Disk Operating System (XVM/DOS) 

b. Batch Operating Software System, BOSS, a component of XVM/DOS 

c. XVM/RSX Software System 

It is assumed in this manual that the reader is familiar with the manual 
describing the software system under which MACRO is to be used. 

The manuals involved are: 

a. XVM/DOS Users Manual 

b. BOSS XVM Users Manual 

c. XVM/RSX System Manual 

Differences in the use of MACRO in the available monitor systems are 
described, where applicable, in this manual. 
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CHAPTER 1 
INTRODUCTION 


1.1 MACRO XVM LANGUAGE 

MACRO is a basic XVM symbolic assembler language which makes machine 
language programming on the XVM easier, faster and more efficient. It 
permits the programmer to use mnemonic symbols to represent instruction 
operation codes, locations, and numeric guantities. By using symbols 
to identify instructions and data in his program, the programmer can 
easily refer to any point in his program, without knowing actual machine 
locations . 

'T’he standard output of the Assembler is a relocatable binary object 
program that can be loaded for debugging or execution by the Linking 
Loader. MACRO prepares the object program for relocation, and the 
Linking Loader, CHAIN or Task Builder, CHAIN (DOS) , or Task Builder 
(RSX) provides relocation and sets up linkages to external subroutines. 
Optionally, the binary program may be output either with absolute 
addresses (non-relocatable) or in the full binary mode (see Chapter 3 
for a description of the binary output modes) . 

The programmer directs the Assembler processing by using a powerful set 
of pseudo-operation (pseudo-op) instructions. These pseudo-ops are 
used to set the radix for numerical interpretation by the Assembler, 
to reserve blocks of storage locations, to repeat object code, to 
handle strings of text characters in 7-bit ASCII code or a special 
6-bit code, to assemble certain coding elements if specific conditions 
are met, and to perform other functions which are explained in detail 
in Chapter 3 . 

The most advanced feature of the Assembler is its powerful macro instruc- 
tion generator. This facility permits easy handling of recurring in- 
struction sequences, changing only the arguments. Programmers can use 
macro instructions to create new language elements, adapting the Assem- 
bler to their specific programming applications. Macro instructions 
may be recursively called up to three levels, nested to any level, 
limited only by available memory, and redefined within the program. 

The technique of defining and calling macro instructions is discussed 
in Chapter 4 . 


1-1 



Introduction 


An output listing, showing both the programmer's source code and the 
object program produced by the Assembler, is printed if desired. This 
listing may include all the symbols used by the programmer with their 
assigned values. If assembly errors are detected, erroneous lines are 
marked with specific alphabetic error codes, which may be interpreted 
by referring to the error list in Chapter 5 of this manual. 

Operating procedures for the MACRO XVM assembler are described in 

* 

detail in Chapter 5. 

1.2 HARDWARE REQUIREMENTS 

The MACRO XVM assembler program may be run in any configuration which 
meets the minimum hardware requirements for the following XVM software 
systems : 

a. Disk Operating System (XVM/DOS) 

b. Batch Operating Software System (BOSS XVM) 

c. Resource Sharing Executive (XVM/RSX) 

1.3 ASSEMBLER PROCESSING 

The Assembler processes source programs in either a two-pass or three- 
pass operation. In the two-pass assembly operation the source program 
is read twice, with the object program and printed listed (both op- 
tional) being produced during the second pass. During PASS 1, the 
locations to be assigned the program symbols are resolved and a 
symbol table is constructed by the Assembler. PASS 2 uses the infor- 
mation computed during PASS 1 to produce the final object program. 

In an optional three-pass assembly operation, PASS 2 calls in PASS 3, 
which performs a cross referencing operation during which a listing 
is produced that contains: (a) all user symbols, (b) where each 

symbol is defined, and (c) the number of each program line in which 
a symbol is referenced. On completion of its operation, PASS 3 calls 
the PASS 1 and PASS 2 portions of the assembler program back into 
core for further assembly operations. 


These procedures are also described in the XVM/DOS Keyboard Command 
Guide and in the On-Line Task Development section of the XVM/RSX 
System Manual . 
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The standard object code produced by the Assembler is in a relocatable 
format which is acceptable to the Linking Loader, CHAIN, PATCH and 
TKB Utility programs. Relocatable programs that are assembled sepa- 
rately and use global symbols* where applicable, can be combined by 
the Linking Loader, CHAIN, and TKB into an executable object program. 
MACRO XVM reserves one additional word in a program for every external 
symbol**. This additional word is used as a pointer (called a transfer 
vector) to the actual data word in another program. The Linking Loader 
CHAIN or task builder sets up these transfer vectors when the programs 
are loaded with the actual address of the global symbol. 

Some of the advantages of having programs in relocatable format are as 
follows : 

a. Reassembly of one program, which at object time was linked with 
other programs, does not necessitate a reassembly of the en- 
tire system. 

b. Library routines (in relocatable object code) can be reguested 
from the system device or user library device. 

c. Only global symbol definitions must be unique in a group of 
programs that operate together. 


Symbols which are referenced in one program and defined in another. 

Symbols which are referenced in the program currently being assembled 
but which are defined in another program. 
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CHAPTER 2 

ASSEMBLY LANGUAGE ELEMENTS 

2 . 1 PROGRAM STATEMENTS 

One or more statements may be written on a line of up to 75 characters 
where the last character is a carriage-return. Since the carriage 
return is a non-printing character, it is graphically represented as 
in this manual, e.g., 

STATEMENT J 

Several statements may be written on a single line, separated by semi- 
colons 

STATEMENT; STATEMENT ; STATEMENT 

Only the last statement may have a comments field, since semicolons 
are allowed in and do not delimit comments. Also, macro calls (a type 
of statement described in a later chapter) should not appear in a multi- 
statement line since they cause subsequent statements to be ignored. 

Normally, a single statement must fit on one line. The exception to 
this rule is a macro call whose arguments may be continued on a subse- 
quent line. This is described in the chapter on macros. 

2.1.1 Basic Statement Format 

A basic statement may contain up to four fields that are separated by 
a space, spaces, or a tab character. These four fields are the label 
(or tag) field, the operation field, the address field, and the com- 
ments field. Because the space and tab characters are not printed, the 
space is represented byi_i, and the tab by -•) in this manual. Tabs are 
set 8 spaces apart on DEC-supplied teleprinter machines, and are used 
to line up the fields in columns in the source program listing. 

This is the basic statement format: 

LABEL -*| OPERATION -•) ADDRESS H /COMMENTS 
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where each field is delimited by a tab or space, and each statement is 
terminated by a semicolon or carriage-return. The comments field is 
preceded by a tab (or space) and a slash (/) . 

Note that a combination of a space and a tab will be interpreted by the 
Assembler as two field delimiters. 

Example : 

TAG H OP i_i ADR both are 
TAG i i ->) OP -*j ADR^J incorrect 

These errors will be flagged by the assembler, but will not show on 
the listing because the space is hidden by the tab. 

A MACRO statement may have an entry in each of the four fields, or 
three, or two, or only one field. The following forms are acceptable 
(where the character (s) indicates one or more of the preceding char- 
acter) : 


TAG — ^ 




TAG 

H 

OP~^ 


TAG 

H 

OP 

— | ADDR 

TAG 

H 

OP 

-*| ADDR lj (s)/coniments«- 

TAG 

H 

OP L_1 

(s) /comments 

TAG 

H 


— | ADDR 

TAG 

H 


H ADDR l_j (s) /comments 

TAG 

H 

(s) /comments 


H 

OP — y 



H 

OP 

H ADDR -- y 


H 

OP 

-»| ADDR H (s) /comments 


H 

OP 

-»| (s) /comments 


H 


H ADDR 


H 


“H ADDR -*j (s) /comments •»- ; 


/comments ^ 

-*| (s) /comments 

A label (or tag) is a symbolic address created by the programmer to 
identify the statement. When a label is processed by the Assembler, 
it is said to be defined. A label can be defined only once. The oper - 
ation code field may contain a machine mnemonic instruction code, a 
pseudo-op code, a macro name, a number, or a symbol. The address field 
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may contain a symbol, number, or expression which is evaluated by the 
assembler to form the address portion of a machine instruction. In 
some pseudo-operations, and in macro instructions, this field is used 
for other purposes, as will be explained in this manual. Comments are 
usually short explanatory notes which the programmer adds to a state- 
ment as an aid in analysis and debugging. Comments do not affect the 
object program or assembly processing. They are merely printed in the 
program listing. Comments must be preceded by a slash (/) . The slash 
(/) may be the first character in a line or may be preceded by: 

a. Space (i_i) . 

b. Tab ( -*) ) 

c. Semicolon ( ; ) 

2.1.2 Direct Assignment Statement 

The Direct Assignment Statement causes no object code to be generated 
by the assembler, but rather equates a value to a symbol at assembly 
time. The format of this statement is: 

symbol=expression /comments 

The symbol is the symbolic name specified to receive the value of the 
expression. The expression is any legal combination of symbols and/or 
constants connected by operators as described in Section 2.3.2. Com- 
ments are optional, as described in Section 2.1.1. 

The direct assignment statement is useful for assigning a symbolic 
name to a constant and controlling conditional assembly. These features 
are explained in detail later on. Unlike labels defined in basic state- 
ments, which must be defined only once, the symbol defined in a direct 
assignment may be redefined at will. 

2 . 2 SYMBOLS 

The programmer creates symbols for use in statements to represent 
addresses, operation codes and numeric values. A symbol contains one 
to six characters from the following set: 

The letters A through Z 
The digits 0 through 9 

Two special characters, period (.) and the percent sign (%) . 
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The first character of a symbol must be a letter, a period, or percent 
sign. A period may not be used alone as a symbol. The letter 'X' alone 
may not be a symbol. ('X 1 and period alone have a special meaning to 
the Assembler, as explained later.) 

The following symbols are legal: 

MARKl ..1234 .A 

AX %50 . 99 .% 

P9.3 INPUT 


The following symbols are illegal: 

TAG:1 : is not a legal symbol character. 

5ABC First character may not be a digit. 

X Letter 'X' alone is illegal. 

' . 1 alone is illegal as a symbol. 

Only the first six characters of a symbol are meaningful to the Assem- 
bler, but the programmer may use more for his own information. If he 
writes , 

SYMBOL 1 
SYMBOL 2 
SYMB0L3 


as the symbolic labels on three different statements in his program, 
the Assembler will recognize only SYMBOL and will print "M" error flags 
on the lines containing SYMROL1, SYMR0L2 and SYMB0L3 . To the Assembler 
they are duplicates of SYMBOL. Mote that "M" errors are not produced 
if the duplicate symbols appear in direct assignment statements. 

2.2.1 Evaluation of Symbols and Globals 

When the Assembler encounters a symbol during processing of a source 
language statement, it evaluates the symbol by referring to two tables: 
the user's symbol table and the permanent symbol table. The user's 
symbol table contains all symbols defined by the user. The user defines 
symbols by using them as labels, as variables, as macro names and 
globals, and by direct assignment statements. A label is defined when 
first used, and cannot be redefined. (When a label is defined by the 
user, it is given the current value of the location counter, as will 
be explained later in this chapter.) 
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All permanently defined system symbols (excluding the index register 
symbol, X) , including system macros (except for XVM/RSX) and all Assem- 
bler pseudo-instructions use a period (.) as their first character. 

The Assembler also has, in its permanent symbol table, definitions of 
the symbols for all of the XVM memory reference instructions, operate 
instructions, the basic EAE instructions, and some input/output trans- 
fer instructions. (See Appendix B for a complete list of these instruc- 
tions . ) 

XVM instruction mnemonic symbols may be used in the operation field of 
a statement without prior definition by the user. 

Example : 

-•j LACuA*^ LAC is a symbol whose appearance in the 

operation field of a statement causes the 
Assembler to treat it as an op-code rather 
than a symbolic address. It has a value 
of 200000g which is taken from the opera- 
tion code definition in the permanent 
symbol table. 

The user can use instruction mnemonics or the pseudo-instruction mne- 
monics code as symbol labels. For example, 

DZM — j DZMi— iY 

where the label DZM is entered in the symbol table and is given the 
current value of the location counter, and the op-code DZM is given the 
value 140000 from the permanent symbol table. The user must be careful, 
however, in using these dual purpose (field dependent) symbols. Sym- 
bols in the operation field are interpreted as either instruction codes 
or pseudo-ops, not as symbolic labels, if they are in the permanent 
symbol table. Macro names cannot also be defined as labels or symbols 
by the user. In the following example, several symbols with values 
have been entered in the user's symbol table and the permanent symbol 
table. The sample coding shows how the Assembler uses these tables to 
form object program storage words. 
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User Symbol Table 

Permanent Symbol Table 

Symbol 

Value 

Symbol 

Value 

TAG1 

100 

LAC 

200000 

TAG 2 

200 

DAC 

040000 

DAC 

300 

JMP 

600000 



X 

010000 


The following statements generate the following code: 
Statemen t Code 


TAG1 

-1 

DAC 

-| TAG 2 

040200 

TAG 2 


LAC 

-| DAC 

200300 

DAC 

H 

JMP 

H TAG1 

600100 


H 

DAC 

TAG 1 , X 

050100 


H 

TAG1 


000100 


2. 2. 1.1 Special Symbols - The symbol X is used to denote index register 
usage. It is defined in the permanent symbol table as having the value 
of 10000. The symbol X cannot be redefined and can only be used in the 
address field. 

2. 2. 1.2 Memory Referencing Instruction Format - When operating in page 
mode the XVM uses 12 bits for addressing, 1 bit to indicate index reg- 
ister usage, 1 bit to indicate indirect addressing, and 4 bits for the 
op-code . 


0 

0 

0 

0 

LiJ 

□J 

IE 

m 

8 

E 

10 

11 

12 

13 

14 

15 

16 

[E 


Op Code 


Address 

L Index Register Bit 
•-Indirect Addressing 

PAGE MODE MEMORY REFERENCE INSTRUCTION 


When operating in bank mode on the XVM, 13 bits are used for address- 
ing, there is no index register bit, 1 bit is for indirect addressing, 
and 4 bits are for the op-code. 
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Op Code 


Address 


■Indirect Addressing 


BANK MODE MEMORY REFERENCE INSTRUCTION 


2.2.2 Variables 

A variable is a symbol that is defined in the user's symbol table by 
using it in an address field or operation field with the number sign 
(#) . Symbols with the # may appear more than once in a program (see 
items 1, 3, 4, and 5 of example given below). A variable reserves a 
single storage word which may be referenced by using the symbol at 
other points in the program with or without the #. If the variable 
duplicates a user-defined label, it is multiply defined and is flagged 
as an error during assembly. 

Variables are assigned memory locations at the end of the program. 

The initial contents of variable locations are unspecified. The # can 
appear any place within the symbol character string as in the example. 

Example : 




2.2.3 Setting Storage Locations to Zero 
Storage words can be set to zero as follows: 

A H .0; H 0; H 0^ 

In this way, three words are set to zero starting at A. 


2-7 







Assembly Language Elements 


2.2.4 Redefining the Value of a Symbol 

The programmer may define a symbol directly in the user's symbol table 
by means of a direct assignment statement written in the form: 

SYMBOL=n 

or 

SYM1=SYM2 

Where n is any number or expression. There should be no spaces between 
the symbol and the equal sign , or between the equal sign and the 
assigned value, or symbol. The Assembler enters the symbol in the 
symbol table, along with the assigned value. Symbols entered in this way 
way may be redefined. These are legal direct assignment statements: 

XX=28;A=1;B=2 — ^ 


A symbol can also be assigned a symbolic value; e.g., A=4, B=A, or 


SET=ISZi iSWITCH 


In the previous example, the symbol B is given the value 4, and when 
the symbol SET is detected during assembly the object code for the 
instruction ISZu-iSWITCH will be generated. This type of direct assign- 
ment cannot be used in a relocatable program. Direct assignment state- 
ments do not generate storage words in the object program. 

In general, it is good programming practice to define symbols before 
using them in statements that generate storage words. 'T’he assembler 
will interpret the following sequence correctly. 
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2.2.5 Forward Reference 

A symbol may be defined after use. For example, 

00 ft 2C00 vJ. A I.-;'' 

000001 
OOQOOv A 
NG i::.RK(lA L.l. Nl::. b 



This is called a forward reference, and is resolved properly in PASS 2. 
When first encountered in PASS 1, the LAC Y statement is incomplete 
because Y is not yet defined. Later in PASS 1, Y is given the value 1. 
In PASS 2, the Assembler finds that Y=1 in the symbol table, and forms 
the complete storage word. 

Since basic assembly operations are performed in two passes, only one- 
step forward references are allowed. The following example is illegal 
because the symbol Y is not defined during PASS 2. 



Forward references to internal . GLOBL symbols (see Paragraph 3.9) are 
illegal because the internal globals are output at the beginning of 
PASS 2 for library searching. Globals must be defined during PASS 1, 
otherwise they will be flagged. The following example is illegal: 
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2.2.6 Undefined Symbols 

If any symbols, except global symbols, remain undefined at the end of 
PASS 1 of assembly, they are automatically defined as the addresses of 
successive registers following the block reserved for variables at the 
end of the program. All statements that referenced the undefined symbol 
are flagged as undefined. One memory location is reserved for each un- 
defined symbol with the initial contents of the reserved location being 
unspecified . 





2 . 3 NUMBERS 

The initial radix (base) used in all number interpretation by the 
Assembler is octal (base 8) . To allow the user to express decimal 
values and then restore to octal values, two radix-setting pseudo-ops 
(.OCT and .DEC) are provided. These pseudo-ops, described in Chapter 
3, must be coded in the operation field of a statement. If any other 
information is written in the same statement, the Assembler treats the 
other information as a comment and flags it as a questionable line. 

All numbers are decoded in the current radix until a new radix control 
pseudo-op is encountered. The programmer may change the radix at any 
point in the program. 

Examples : 
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2.3.1 Integer Values 


An integer is a string of digits, with or without a leading sign. 
Negative numbers are represented in two's complement form. The range 
of integers is as follows: 


Unsigned 

Signed 


0 

0 

0 


10 


262143 

131071 io 

-131072 


10 


(777777 g ) or 2 18 -1 
( 377777 g ) or 2 17 -1 
(400000 ) or -2 17 

O 


An octal integer* is a string of digits (0-7), signed or unsigned. If 
a non-octal digit (8 or 9) is encountered the string of digits will be 
assembled as if the decimal radix were in effect and it will be flagged 
as a possible error. 


Example: 





0 0 / 3 0 3 A 


00001 R 777773 A 
0 0 0 0 A. i 0 A 3 * r 4 / j . ; 

ij Q \) Cf A • :| 

1 i::. k H (.) K L .i. N i::. B 







/ J.J i::. 


A decimal integer** is a string of digits (0-9) , signed or unsigned. 

Examples : 



Preceded at some point by an .OCT pseudo-op and is also the initial 
assumption if no radix control pseudo-op is encountered. 

Preceded at some point by a .DEC pseudo-op. 
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2.3.2 Expressions 

Expressions are strings of symbols and numbers separated by arithmetic 

or Boolean operators. Expressions represent unsigned numeric values 

1 8 

ranging from 0 to 2 -1. All arithmetic is performed in unsigned inte- 

1 8 

ger arithmetic (two's complement), modulo 2 . Division by zero is 

regarded as division by one and results in the original dividend. 
Fractional remainders are ignored; this condition is not regarded as 
an error. The value of an expression is calculated by substituting 
the numeric values for each symbol of the expression and performing 
the specified operations. 

The following are the allowable operators to be used with expressions: 


Character 



Name 

Symbol 

Function 

Plus 

+ 

Addition (two 1 

s complement) 

Minus 

- 

Subtraction (convert to two's 
complement and add) 

Asterisk 

★ 

Multiplication (unsigned) 

Slash 

/ 

Division (unsigned) 

Ampersand 

& 

Logical AND ^ 


Exclamation 

point 

] 

Inclusive OR 

> 

Back slash 

\ 

Exclusive OR 

Boolean 

Comma 

/ 

Exclusive OR > 



Operations are performed from left to right (i.e., in the order in which 
they are encountered) . For example, the assembly language statement 
A+B*C+D/E-F*G is equivalent to the following algebraic expression 
( ( ( ( (A+B) *C)+D)/E) -F) *G. 

Examples : 

Assume the following symbol values: 


Symbol 

Value (Octal) 

Comments 

A 

000002 


B 

000010 


C 

000003 


D 

000005 


X 

010000 

Index Register Value 
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The following expressions to be evaluated: 


Expression Evaluation (Octal) Comments 


A+B-C, X 

010007 

A/B+A*C 

000006 

B/A-2*A-1+X 

010003 

A & B 

000000 

C+A&D 

000005 

B*D/A 

000024 

B*C/A*D 

000074 

A, X+D, X 

010007 


Index Register Usage 

(The remainder of A/B 
is lost) 

Index Register Usage 


Index Register Usage 
Error 


In the last example the expression is evaluated as follows: 

Sequence of arithmetic 

a. A,X = 000002 XORed with 010000 = 010002 

b. A, X+D = 010002 + 000005 = 010007 

c. A, X+D , X = 010007 XORed with 010000 = 000007 

Note that arithmetic produces 000007 yet the value given in the example 
is 010007. Regardless of how the index register is used in the address 
field, the index register bit will always be turned on by the Assembler. 
In the sequence of address arithmetic above, the line would be flagged 
with an X because of the illegal use of the index register symbol (X) . 

Using the symbol X to denote index register usage causes the following 
restrictions : 

a. X cannot appear in the TAG field X -*| LAC H A 

b. X cannot be used in a .DSA statement -*| .DSaH A,X 

c. X can be used only once in an expres- -*| LAC —\ A,X+P,X 

sion (see 2.4.3) 

2.4 ADDRESS ASSIGNMENTS 


As source program statements are processed, the Assembler assigns con- 
secutive memory locations to the storage words of the object program. 
This is done by reference to the location counter, which is initially 
set to zero and is incremented by one each time a storage word is formed 


2-13 



Assembly Language Elements 


in the object program. Some statements, such as machine instructions, 
cause only one storage word to be generated, incrementing the location 
counter by one. Other statements, such as those used to enter data or 
text, or to reserve blocks of storage words, cause the location counter 
to be incremented by the number of storage words generated. 

2.4.1 Referencing the Location Counter 

The programmer may directly reference the location counter by using the 
symbol period (.) in the address field. He can write, 

JMP LJ - - 1 

which will cause the program to jump to the storage word whose address 
was previously assigned by the location counter. The location counter 
may be set to another value by using the .LOC pseudo-op, described in 
Chapter 3 . 

2.4.2 Indirect Addressing 

To specify an indirect address, which may be used in memory reference 
instructions, the programmer writes an asterisk immediately following 
the operation field symbol. This sets the defer bit (bit 4) of the 
storage word. 

If an asterisk suffixes either a non-memory reference instruction, or 
appears with a symbol in the address field, an error will result. 

Two examples of legal indirect addressing follow. 

H TAD* H A 
H LAC* H B 

The following examples are illegal. 

-») CLA* Indirect addressing may not be specified 

H LAW*i_il7777 in non-memory reference instructions. 
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2.4.3 Indexed Addressing 

To specify indexed addressing an X is used with an operator directly 
after the address. No spaces or tabs may appear before the operator. 
The Assembler will perform whatever operation is specified with the 
index register symbol, and then continue to evaluate the expression. 

At completion of the expression evaluation, if the index bit (bit 5) 
is not on and the location counter is pointing to page 0 of any bank, 
the line is flagged with a B for bank error because the address (aside 
from indexing modifications) must have been greater than 7777^ (i.e., 
it pointed to another page) . The standard code used to indicate index 
ing is: 


-*) LAC HA,X 


The indexed addressing operation is illustrated in the following 
example . 



Expression evaluation where A = 000000, B = 000001, C = 010000, 
D = 010001, X = 010000 

NOTE: (?) = exclusive OR 


Location 


Address Field 


Discussion 


0 X The value of X is added to 0. 

Absence of an operator always 
implies addition. 

1 A, X+l ,7-1 000000 © 010000 = 010000 

010000 © 000001 = 010001 
010001 © 000007 = 010006 
010006 - 000001 = 010005 


2 


B+X 


000001 © 010000 = 010001 
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Location Address Field Discussion 

10000 X, D 010000 © 010001 = 000001 

The index bit has been 
turned off during expres- 
sion evaluation. Because 
the location counter (10000) 
is pointing to Page 1, this 
line is not flagged, and the 
index register bit is turned 
on . 

10001 C,X 010000 © 010000 = 000000 

Same as example at Location 

10000 . 


2.4.4 Literals 


Symbolic data references in the operation and address fields may be 
replaced with direct representation of the data enclosed in parentheses 
This inserted data is called a literal. The Assembler sets up the 
address link, so one less statement is needed in the source program. 

The following examples show how literals may be used, and their equiv- 
alent statements. The information contained within the parentheses, 
whether a number, symbol, expression, or machine instruction, is 
assembled and assigned consecutive memory locations after the locations 
used by the program, unless a .LTORG pseudo-instruction appears in the 
program. (See section 3.2.5.) The address of the generated word will 
appear in the statement that referenced the literal. 


Duplicate literals, completely defined when scanned in the source pro- 
gram during PASS 1, are stored only once so that many uses of the same 
literal in a given program result in the allocation of only one mem- 
ory location for that literal. Nested literals, that is, literals 
within literals, are illegal and will be flagged as a literal (L) error 
The following is an example of a nested literal. 

LAC u-i (ADD i— i ( 3 ) ) 


Usage of Literal 
ADD i_« ( 1 ) 

-~| LAC i_j ( TAG ) 

-*| LAC i_i(DAC H TAG) 

-*) LAC i_j( JMP H .+2) 


Equivalent Statements 

H ADDi_iONE 
One 1 

-\ LACi_iTAGAD 
TAGAD -\ TAG 

H LAC INST 

INST DAC TAG 

HERE H LAC lj INST 
INST -j JMP »_i HERE+2 
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The following sample program illustrates how the Assembler handles 
literals . 


:!. 

00000 

R 2000 

1.0 ft 

TAGl 

LAC 

( 1.00) 



0000 .1. 

R 0401 

00 A 

IU 

DAG 

! 00 


3 

00002 

r 2 0 0 0 

!.:l. ft 


L. A C 

\ Ji v 1P 

, 4-5 ) 

4 

00003 

R 2000 

1.2 ft 


i.. A (0 

< TAG! 

) 

5 

00004 

R 2000 

1.3 ft 


LAC 

( JMP 

TAG 1. 

6 

00005 

R 2 0 0 0 

1.3 R 


1... A C 

( JMP 

TAG 2 

y 


0000 

‘)0 R 

TAG2™ 

TAG 1 



a 

00006 

R 2000 

1.4 ft 


LAC 

; jhp 

0 ) 

9 

00007 

ft 2000 

1.5 R 

D A C 

LAC 

(DAC 

DAC; ) 

o 


0000 

00 A 


v END 




000 .1.0 

ft 0001 

0 0 A 

m... 





0001 1 

R 6000 

07 R 

*i... 





000.1.2 

ft 0000 

00 R 

sKL 





000 1 3 

R 6 0 0 0 

"j Q 






0 0 0 t 4 

R 6000 

00 A 

* 1... 





ooois 

R 0 4 0 0 

:> 7 r 

#L 




E- 000:1 

7 NO 

ERROR 

... :i: NE; 

$ 





2.5 STATEMENT FIELDS 


The following paragraphs provide a detailed explanation of statement 
fields, including how symbols and numbers may be used in each field. 

2.5.1 Label Field 

If the user wishes to assign a symbolic label to a statement in order 
to facilitate references to the storage word generated by the Assembler, 
he may do so by beginning the source statement with any desired symbol. 
The symbol must not duplicate a system or user defined macro symbol and 
must be terminated by a space or tab, or a statement terminating semi- 
colon or carriage-return. 

Examples : 

TAG-*] jar ; TAG2 0 ; TAG3 -j 0 ; TAG4-*) 0 

A new logical line starts after each semicolon. This line is equivalent 
to 

TAGl H 
TAG 2 -»| 0 

TAG 3 H 0-R 
TAG 4 H 0^ 
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If there were a tab or a space after 
evaluated as an operation instead of 


the semicolon the symbol would be 
a label. The sequence: 


TAG H 0; H TAG 2 ; TAG 3 H 0; H TAG 4 


is evaluated as follows: 

TAGl H 0— ' 

" H TAG 2 V 

TAG 3 H0^ 

H TAG 4 — 7 

When writing numbers separated by semicolons, the first number must be 
preceded by a tab ( H ) or a space ( u_i) . The sequence 

TABLE i il ; 2 ; 3 ; 4 ; 5 

produces symbol (S) errors because the first symbol of a tag cannot be 
numeric. The correct way to write the table sequence is as follows: 

TABLE i_jl ; l_j 2 ; i_, 3 ; ,_j 4 ; , , 5 

Symbols used as labels are defined in the symbol table with a numerical 
value equal to the present value of the location counter. A label is 
defined only once. If it was previously defined by the user, the cur- 
rent definition of the symbol will be flagged in error as a multiple 
definition. All references to a multiply defined symbol will be con- 
verted to the first value encountered by the Assembler. 



Anything more than a single symbol to the left of the label-field 
delimiter is an error; it will be flagged and ignored. The following 
statements are illegal. 
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The line will be flagged with an S for symbol error. The label will 
be ignored but the rest of the line will continue to be processed. 

The only time that an error tag is not ignored is when the error occurs 
after the sixth character. 

The statement: 

TAG ERROR *li_, NOP 

will be assembled as: 

TAGERR H NOP 


and the line will be printed and flagged with an S. 


Redefinition of certain symbols can be accomplished by using direct 
assignments; that is, the value of a symbol can be modified. If an 
Assembler permanent symbol or user symbol (which was defined by a direct 
assignment) is redefined, the value of the symbol can be changed with- 
out causing an error message. If a user symbol, which was first de- 
fined as a label, is redefined by either a direct assignment or by 
using it again in the label field, it will cause an error. Variables 
also cannot be redefined by a direct assignment. 

Examples : 


000 ‘j' 


0 0 0 0 0 R 2 0 0 0 0 3 
0 0 C 0 1 R 0 4 0 0 0 3 
0 0 0 0 0 4 




I... R L 

mi 


R 

R 


1 U 

I 1 
12 
12 
i 4 
;j. 3 
16 
1 7 

S12E-0000 


00002 E 200004 A LAC 

00003 ft 04 000-4 A B DAC 

00 0004 A B- A 

000003 ft A-B 

1 2 3 4 3 0 A t" S ; :r - ; .1 2 3 4 3 & 

0 0 0 0 4 E 0 4 0 0 0 3 R l 1 A C 

00003 ft 123433 A PSF 

000000 A .ELD 

i ERROR LINES 


rr value 


'Tlr 



JE OF 


/ERROR? A LABEL CAN 
/NOT BE REDEFINED 
/BUT 'A' CAN BE RE- 

/ N \i N T S Y M B 0 i... 

/NOTE NEW VALUE 
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2.5.2 Operation Field 

Whether or not a symbol label is associated with the statement, the 

operation field must be delimited on its left by a space (s) or tab. 

If it is not delimited on its left, it will be interpreted as the label 

field. The operation field may contain any symbol, number, or expression 

which will be evaluated as an 18-bit quantity using unsigned arithmetic 
1 8 

modulo 2 . In the operation field, machine instruction op codes and 

pseudo-op mnemonic symbols take precedence over identically named user 
defined symbols. The operation field must be terminated by one of the 
following characters: 

-*j oru(s) (field delimiters) 

or ; (statement delimiters) 

Examples : 

\ . K \ ’ ; • .* ■> K 

*.J : i 

The asterisk (*) character appended to a memory reference instruction 
symbol, in the operation field, causes the defer bit (bit 4) of the 
instruction word to be set; that is, the reference will be an indirect 
reference. If the asterisk (*) is appended on either a non-memory 
reference instruction or any symbol in the address field, it will cause 
an error condition which will be flagged as a symbol error (S-flag) . 

The asterisk will be ignored and the assembly process will continue. 

Examples : 


S .!. I . = ' O 0 0 0 ii E 0 R 

where A = 1 and B = 2 

However, the asterisk (*) may be used anywhere as a multiplication 
operator . 
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Examples : 


3 R 00001 R 

A 

5 QRU 00002 R 

6 QU 00003 R' 


SIZE "00006 


200000 K 
000000 R 


000004 f< 
000000 A 
RROR LINES 


TAG 


! A U A 5 AG I. 

!... A C : A G k . ; ! f T A Jj & 

A A 
. r Kj ;'i 


2.5.3 Address Field 

The address field, if used in a statement, must be separated from the 

operation field by a tab, or space(s). The address field may contain 

any symbol, number, or expression which will be evaluated as an 18-bit 

18 

quantity using unsigned arithmetic, modulo 2 . If op code or pseudo-op 

code symbols are used in the address field, they must be user defined, 
otherwise they will be undefined by the Assembler and will cause an 
error message. The address field must be terminated by one of the 
following characters: 


-| or i_i(s) 

.*/ or ; 


(field, delimiters) 
(statement delimiters) 


Examples : 


LAW -1 
LAW-1 


/Correctly assembled as 777777 

/No separation from the operation field; assembled 
as 757777 since -1 is treated as part of the oper- 
ation field. 


TAG 2 H DAC 

H 


H .+3 

TAG2/5+3 u_i(s) 


The address field may also be terminated by a semicolon or a carriage- 
return . 


Examples : 

-j JMP BEGIN — ^ 

H TAD H A; H DAC H B H LAC 

In the last example, a tab or space (s) is required after the semicolon 
in order to have the Assembler interpret DAC as being the operation 
field rather than the label field. 
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In the second line of the preceding example, the address field B is 
delimited by a tab. The LAC after the B H is ignored and is treated 
as a comment; but the line is flagged as questionable because only a 
comment field may occur on a line after the address field. If the LAC 
had been preceded by a slash (/) , the line would have been correct. 

When the address field is a relocatable expression, an error condition 
may occur. If the program is being assembled to run in page mode, it 
could not execute properly if its size exceeded 4 K (4096) words because 
it would have to load access a memory page or bank boundary. In prac- 
tice, the binary loaders restrict the size to 4K-16 (4080) to avoid 
loading a program into the first 16 locations in a memory page or bank. 
This avoids a possible ambiguity where indirect memory references would 
be mistaken for autoincrement register references. Consequently, any 
relocatable address field whose value exceeds 4095 (7777g) is meaningless 
in page mode and will be flagged by the Assembler as an error. 

There is a similar size restriction for programs being assembled to 
operate in bank mode. The Assembler flags in error any relocatable 
address field whose value exceeds 8191 (17777 „) . The binary loaders 

O 

restrict the size of bank mode program to 8K-16 (8176) words. 

When the address field is an absolute expression, an error condition 
will exist if the extended memory and page address bits (3, 4, and 5) 
do not match the corresponding bits of the address of the page currently 
being assembled into. 


NOTE 

In absolute mode, the page bits do not have to 
be equal if the .ABS or .FULL pseudo-ops are used 
instead of the .ABSP or .FULLP pseudo-ops. 
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The Linking Loader will not relocate any absolute addresses; thus, 
absolute addresses within a relocatable program are relative to that 
page in memory in which the program is loaded. 

Example : 

Assume that the following source line is part of a relocatable program 
that was loaded into bank 1 (20000g -* 37777 g ) . 

Source Statement Effective Address 

LACi_,300 20300 

An exception to the above rule is the auto-index registers, which occupy 
locations 10 o - 17 c in page 0 of memory bank 0. The hardware will 

O O 

always ensure that indirect references to 10_ - 17_ in any page or bank 

O O 

will access 10 - 17 of bank 0. 

O O 

2.5.4 Comments Field 

Comments may appear anywhere in a statement. They must begin with a 
slash (/) that is immediately preceded by one of the following: 


a . 

1— 1 (s) 

space (s) 

b. 

H 

tab 

c . 


carriage return/line feed (end of previous line) 

a. 

; 

semicolon 


Comments are terminated only by a carriage-return or when 74^ p char- 
acters have been encountered in a line. 

Examples : 

■ i ( s) /THIS IS A COMMENT (rest of line is blank) 

TAG1 -\ LAC i_j 
/THIS IS A COMMENT 
-*) RTRl_j/ COMMENT 

H RTR; -*) RTR;/THIS IS A COMMENT 

Observe that; -*| A/COMMENT i s not a comment, but rather an operation 
field expression. A line that is completely blank (containing 0 to 75 
blanks/spaces) is treated as a comment by the Assembler. 
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A statement is terminated as follows: 

or; or rest of line is completely blank. 

Examples : 

-| LAC 

H DAC (the rest of the line is blank) 

H TAG+3 

— | RTR ; H RTR ; -*\ RTR 

In the last example, the statement-terminating character, which is a 
semicolon ( ; ) enables one source line to represent more than one word 
of object code. A tab or space is required after the semicolon in order 
to have the second and third RTRs interpreted as being in the operation 
field and not in the label field. 

2 . 6 STATEMENT EVALUATION 

When the Assembler evaluates a statement, it checks for symbols or 
numbers in each of the three evaluated fields: label, operation, and 

address. (Comment fields are not evaluated.) 

2.6.1 Numbers 

Numbers are not field dependent. When the Assembler encounters a num- 
ber (or expression) in the operation or address fields (numbers are 
illegal in the label field) , it uses those values to form the storage 
word. The following statements are equivalent: 



All three statements cause the Assembler to generate a storage word 
containing 200010. A statement may consist of a number or expression 
which generates a single 18-bit storage word; for example: 

-*) 23;i_j45;i_j357;l_j62 
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This group of four statements generates four words interpreted under 
the current radix. 

2.6.2 Word Evaluation 

When the Assembler encounters a symbol in a statement field, it deter- 
mines the value of the symbol by reference to the user 1 s symbol table 
and the permanent symbol table, according to the priority list shown in 
paragraph 2.6.4. 

The operation field is scanned for the following special cases: 

Mnemonic Operation Field Value 

LAW 760000 

AAC 723000 

AXR 737000 

AXS 725000 

EAE instructions 64xxxx 

If the operation field is not one of the special cases, the object word 
value is computed as follows: 

If assembling for page mode: 

(Operation Field + (Address Field & 7777))=Word Value 

If assembling for bank mode: 

(Operation Field +(Address Field & 17777) ) =Word Value 

If the index register is used anywhere in the address field, the index 
register bit is set to one in the word value. If it is not used, and 

you are assembling for page mode then the index register bit is set to 
zero in the word value regardless of the address field value. 

a. If index register usage is specified, the result of XORing 

bit 5 of the location counter and bit 5 of the address field 
value must be non-zero. (Otherwise the address without index 
modification was in a different page than the location counter, 
and the line is flagged with a B for bank error) . 
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Example : 


2 

00000 

210001 

LAC 

A LX /F 

3 

00001 

7 4 0 0 0 0 A 

NOP 


4 

1 0000 


LDC 

10000 /T 

k:; 

10000 

2 1 000 1 

LAC 

B t X 

6 

loooi 

210001 8 

LAC 

A y X 


7 000000 -'END 

SIZE =1000 2 NO ERROR LINES 




The result of statement evaluation has produced the following results: 

A, X = 10001 A = 00001 

B , X = 00001 B = 10001 

Note that when index register usage is specified, the index register 
bit may or may not be on. For B,X above, the index register bit was 
turned off during statement evaluation. The Assembler turns this bit 
on after the word is evaluated, not at statement evaluation time. 

At location 10001, the result of XORing bit 5 of A,X and bit 5 of the 
location counter is 0. This signals the Assembler that the address 
reference (A) is in a different page. 

b. If index register usage is not specified and the program is 
not assembled for bank mode*, the result of XORing bit 5 of 
the location counter and the address field value must be 0, 
otherwise the line is flagged with a B for bank error. 


★ 

See pseudo-ops .ABS, .ABSP, .FULL, . FULLP , .EBREL, . DBREL . 
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Example: 


:l. 

2 

B 00000 

210500 

, A BSP 
LAC 

A 

3 

10500 


* L0C 

1 0500 

4 

10500 

740000 A 

NOP 


5 


000000 

» END 



SIZE ""l 050:1. 1 ERROR LINES 


c. The bank bits (3,4) of the address field value in a relocatable 
program must never be on. The bank bits are always lost when 
the address field value and the operation are combined to form 
the object word value. 


Example: 


B 00000 E 200000 R 


4 


s:i:ze= 2ooo:i. 


3.7777 R 

1 7 7 7 7 R 7 4 0 0 0 0 A 
20000 R 740000 A 
000000 A 
:!. i::. k !•"■: !J R !... I N E S 


, LOG C+17777 
NOP 


d. The bank bits of an absolute program must equal the bank bits 
of the location counter. If not, the B flag alerts the pro- 
grammer that he is referencing another bank. 


Example : 


:i. 

■”> 

3 

4 


u 



B 


B 


SIZE-20003 


v 0 Q Q Q 

20000 200001 
20001 20000 . 1 . 
20002 200001 
0 0 0 0 0 0 

2 ERROR LINES 


, A BSP 

♦ LC'H 20000 

LAC .1. 

LAC 2 ,’001 

LAC 40001 

, END 
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e. The bank bits of lines 3 and 5 do not match those of the loca- 
tion counter, therefore, the lines are flagged. 

2.6.3 Word Evaluation of the Special Cases 

a. LAW - The operation field value and the address field value 
are combined as follows: 

Operation Value + (Address Field Value & 17777) = Word Value 

A validity check is then performed on the address field value 
as follows: 

Address Field Value & 760000 = Validity Eits 

If the validity bits are not equal to 760000 or 0, the line 
is flagged with an E to signal erroneous results. 

b. AAC, AXR, AXS - The operation field value and the address 
field value are combined as follows: 

Operation Value + (Address Field Value & 000777) = Word 
Value 

The validity check: 

Address Field Value & 777000 = Validity Bits 

If the validity bits are not equal to 777000 or 0, the line 
is flagged with an E to signal erroneous results. The address 
field value for this type of instruction cannot be relocated. 
The line is flagged with an R if the address field value is 
relocatable . 

c. EAE class instructions - The operation field value and the 
address field value are combined as follows: 

Operation Value + Address Field Value = Word Value 

The validity check: 

word value and 640000 = Validity Bits 
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A validity check is then performed on the word value. If the 
validity bits differ from 640000, the line is flagged with an 
E error to signal erroneous results. 


:l. 

00000 R 

/ / / / / / )' •'! 

LAW 

17777 


00001 R 
E 00002 R 

777777 a 

I... f ; ! W 



3 

7 7 / 7 7 7 A 

LAW 


4 

00003 R 

760000 A A 

i... A W 


5 

000 (M R 

723776 A 

A AC- 

-2 


00005 R: 

/23123 A 

A AC 

1 23 

7 

I- 00006 ft 

723000 A 

A AC 

— 2 (•' 00 

O 

00007 R; 

750000 A 

CL. A 

4 0 0 0 0 

9 

E 0 0 0 1 0 R: 

7 5 3 3 2 3 A 

1 1 1 1 0 

i. 000 0 ( 

j 9 

0001.1 R 

000023 A 

...; 


:l. :i. 


0 0 0 0 0 0 A 

, ENU 


ZE :::: 000 

j. 2 3 1 

’ R ! ■: D R i... j. i\ iii 3 




If numbers are found in the operation and address fields, they are 
combined in the same manner as defined symbols. For example, 

H 2 H 5 H /GENERATES 000007 

The value of a symbol depends on whether it is in the label field, the 
operation field, or the address field. The Assembler attempts to 
evaluate each symbol by running down a priority list, depending on the 
field, as shown below. 

2.6.4 Assembler Priority List 



Operation Field. 


Address Field 

i . 

Pseudo-op 

1 . 

The indexing symbol, X 

2. 

User or System macro 
in macro table 

2. 

User symbol table (includ- 
ing direct assignments) 

3. 

Direct assignment in 
user symbol table 

3. 

Undefined 

4 . 

Permanent symbol 
table 



5. 

User symbol table 



6. 

Undefined 
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This means that if a symbol is used in the address field, it must be 
defined in the user's symbol table before the word is formed during 
PASS 2; otherwise, it is undefined. (See section 2.2.4) 

In the operation field, pseudo-ops names take precedence. Direct 
assignments allow the user to redefine machine op codes, as shown in 
the example below. 

Example : 

DPOSIT = DAC 


System macros may be redefined by user macros, but may not be redefined 
as user symbols by direct assignment or by use as statement labels. 

The user may use machine instruction codes and pseudo-op codes in the 
label field and refer to them later in the address field. 
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CHAPTER 3 
PSEUDO OPERATIONS 


The Assembler has definitions in its permanent symbol table of the 
symbols for all the XVM memory reference instructions, operate instruc- 
tions, the basic EAE instructions, and many commonly used IOT instruc- 
tions which may be used in the operation field without prior defini- 
tion by the user. Also contained in the permanent symbol table are a 
class of symbols called pseudo-operations (pseudo-ops) which, instead 
of generating instructions, generate data or direct the Assembler on 
how to proceed with the assembly. 


By convention, the first character of every pseudo-op symbol is a 
period (.) . This convention is used in an attempt to prevent the 
programmer from inadvertently using, in the operation field, a pseudo- 
instruction symbol as one of his own. 

The following is a summary of MACRO XVM Pseudo-ops. 


Pseudo-op 

Section 

Function 

.ABS 
. ABSP 

3.2.0 
3.2.1 J 

Object program is output in absolute, blocked, 
checksummed format for loading by the Absolute 
Binary Loader. (Neither is supported with 

XVM/RSX.) 

.ASCII 

3.8.1 

Input text strings in 7-bit ASCII code, with 
the first character serving as delimiter. Octal 
codes for non-printing control characters are 
enclosed in angle brackets. 

.BLOCK 

3.5 

Reserves a block of storage words equal to the 
expression. If a label is used, it references 
the first word in the block. 

. CBC 

3.5.4 

Initializes a word of a common block to a con- 
stant . 

. CBD 

3.18 

Common Block Definition. 

. CBDR 

3.19 

Common Block Definition Relative. 

.CBE 

3.5.5 

End common block initialization section. 

.CBS 

3.5.3 

Start common block initialization section. 

. DBREL 

3.2.3 

Disable bank mode reloation. 
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Pseudo-on 

Section 

Function 

.DEC 

3.4 

Set prevailing radix to decimal. 

.DEFIN 

3.16 

Macro definition. 

. DSA 

3.11 

Generates a transfer vector for the specified 
symbol . 

.EBREL 

3.2.3 

Enable bank mode relocation. 

.EJECT 

3.14 

Skip to head of form on listing device. 

• END 

3.6 

Must terminate every source program. The 
address field contains the address of the first 
instruction to be executed. 

. ENDC 

3 .13 

Terminates conditional coding resulting from 
.IF statements. 

. ENPM 

3 .16 

Terminates the body of a macro definition. 

.EOT 

3.7 

Must terminate physical program segments, ex- 
cept the last, which is terminated by .END. 

.ETC 

3.16 

Used in macro definitions to continue the list 
of dummy arguments on succeeding lines. 

.FULL 
. FULLP J 

3.2.2 

Produces absolute, unblocked, unchecksummed 
binary object programs. Used only for paper 
tape output. (Neither supported with XVM/RSX.) 

. GLOBL 

3.9 

Used to declare all internal and external 
symbols which reference other programs. 

. IFxxx 

3 .13 

If a condition is satisfied, the source coding 
following the .IF statement and terminating with 
an .ENDC statement is assembled. 

. IODEV 

3 . 10 

Specifies .DAT slots and associated I/O handlers 
required by this program. (Not supported with 

XVM/RSX . ) 

.LOC 

3 . 3 

Sets the location counter to the value of the 
expression . 

.LOCAL 

3.2.4 

Allows deletion of certain symbols from the user 
symbol table. 

. LST 

3.17 

Continues requested assembly listing output of 
source lines. Lines between .NOLST and .LST 
are not listed. 

. LTORG 

3.2.5 

Allows the user to specifically state where 
literals are to be stored. 

.NDLOC 

3.2.4 

Terminates deletion of certain symbols from the 


user symbol table contained between .LOCAL and 
. NDLOC . 
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Section 

Function 

•NOLST 

3.17 

Terminates requested assembly listing output of 
source lines of code contained between .NOLST 
and . LST . 

.OCT 

3.4 

Sets the prevailing radix to octal. Assumed at 
start of every program. 

.REPT 

3.12 

Repeats the object code of the next object code 
generating instruction. 

. SIXBT 

3.8.2 

Input text strings in 6-bit trimmed ASCII with 
first character as delimiter. 

■ SIZE 

3.15 

Outputs the address of last location plus the one 
occupied by the object program. 

.TITLE 

3.1 

Causes the assembler to accept characters to be 
printed at the top of each page of assembly 
listing and in the Table of Contents. 


3.1 LISTING CONTROL PSEUDO-OPERATIONS 

3.1.1 Program Segment Identification (.TITLE) 

The program name (or any text) may be written in a .TITLE statement 
as shown in the following examples. The Assembler will accept up to 
50 ^ q characters typed until a carriage return. A form feed is output 
to the listing when .TITLE is encountered in the source program. The 
text will appear at the top of each form (page) until the next .TITLE 
pseudo-op. The .TITLE pseudo-op has no effect on the listing file 
name . 


H .TITLEt_,NAME OF PROGRAM 

-*) . TITLEujNAME OF SUBSECTION IN PROGRAM 

If subsections in a program are headed by .TITLE statements, these 
can be used to produce a table of contents at the head of the assembly 
listing by use of the T option. 

3.1.2 Listing Control (.EJECT) 


Label Field 

Operation Field 

Address Field 

Not used 

. EJECT 

Not used 


When .EJECT is encountered anywhere in the source program, it causes 
the listing device that is being used to skip to top-of-form. 
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3.1.3 Listing Output Control (.NOLST and .LST) 


Label Field 

Operation Field 

Address Field 

Not used 

1 

f .nolst'I 

N ‘ LST J 

1 

Not used 


If, while performing an assembly listing operation (L, or N assembly 
parameters) , the Assembler encounters a .NOLST, the listing operation 
will be terminated until a .LST is found. These pseudo-ops are useful 
when the user wishes to assemble all of a program, but only needs a 
listing of certain modules of the program (e.g., those which may not 
yet work properly) . All symbols occurring between .NOLST and .LST 
will appear in the cross reference and symbol table listings when re- 
quested (A, V, X, or S assembly parameters) . 

3 . 2 OBJECT PROGRAM OUTPUT PSEUDO-OPERATIONS 

The normal object code produced by the Assembler is relocatable binary 
which is loaded at run time by the Linking Loader or loaded to build an 
executable task by CHAIN or TKB . In addition to relocatable output, the 
user may specify other types of output code to be generated by the 
Assembler . 

3.2.1 Absolute Format {.AI3SP and .ABS) (Not available on XVM/RSX) 

. ABSP and .ABS, although accepted by the Assembler, will not work 
properly in XVM/RSX systems because none of the I/O handlers accept 
dump mode data. 


Label Field 

Operation Field 

Address Field 

Not used 
Not used 

• ABSP 

• ABS 

NLD oruor not specified 
NLD oruior not specified 


Both pseudo-ops cause absolute, checksummed binary code to be output 
(no values are relocatable) . If no value is specified in the address 
field and if the output device is the paper tape punch, the Assembler 
will precede the output with the Absolute Binary Loader (ABL) , which 
will load the punched output at object time. The ABL is loaded, via 
hardware readin, into location 17720 of any memory bank. (The ABL 
loads only the paper tape which follows it.) If the address field of 
the pseud.o-op contains NLD, indicating "no loader", or if the binary 
output device is not the paper tape punch, the ABL will not precede 
the output. 
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17720 


.AES 

LOADER 


USER PROGRAM 


. END START 



J 


PAPER TAPE 


NOTE 

.APS (P) output can be written on directoried 
devices. The Assembler assumes .ABS(P) NLD for 
all . ABS (P) output to f ile-orient.ed devices and 
appends an extension of ABS to the filename. 
This file can be punched with PIP, using Pump 
Mode. (There will be no absolute loader at the 
beginning of the tape.) 


a. The .ABS, . ABSP, .FULL, and . FULLP pseudo-ops, specifying the 
type of output, must appear before any statements generating 
object code, otherwise the line will be flagged and ignored. 
Once one of these four pseudo-ops is specified, the user is not 
allowed to change output modes. 

b. The NLD option provided in the address field of .ABS and .ABSP 
is meaningful only if the output device is paper tape. 


A description of the absolute output format follows. 


Binary Data Block (variable length, up to 34 R words) 


WORD 1 
WORD 2 
WORD 3 

WORD 4 


Starting address to load the block body which follows. 

Number of words in the block body (two's complement) . 

Checksum of block body (two's complement of words 
1 and 2, 4 through n) . 

Binary data to load. 


WORD 3+n Binary data to load 


Starting Block - (two binary words) 


WORD 1 location to start execution of program. It is distin- 
guished from the binary data block by having bit 0 set 
to 1 (negative) . 

WORD 2 Dummy word . 


If the user requests the absolute loader and the value of the expres- 
sion of the .END statement is equal to 0, the ABL halts after it has 
loaded in the object program. To start the program the user must set 
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the starting address in the console address switches and press START. 
m his allows manual intervention by the user, typically to ready I/O 
devices prior to starting his program. If the value of the . FNP expres- 
sion is non-zero, it is treated as the program start address to which 
the ABL will automatically transfer control after loading the object 
program . 

The .ABSP pseudo-op causes all memory referencing instructions whose 
addresses are in a different page to be flagged as bank errors. A DBA. 
instruction is executed by the absolute loader before control is given 
to the user program. Word values which have bit 5 on will signal the 
processor to use the index register to compute effective addresses. 

The .ARB pseudo-op does not flag memory referencing instructions whose 
addresses are in a different page. An FBA instruction is executed, 
and control is given to the user in bank addressing mode. Complete 
bank addressing of 8K is allowed. The processor will interpret bit 5 
of all memory referencing instructions as the high order address bit. 

A listing of the Absolute Binary Loader is given in Appendix F. 

3.2.2 Full Binary Format (.FULL and . FULLP) (Dot available in XVM/RSX) 

.FULL and .FULLP, although, accepted by the Assembler, will not work 
properly in XVM/RSX systems because none of the I/O handlers accept 
dump mode data. 


Label 

Field 

Operation Field 

Address Field 

(Only useful 

Hot 

used 

. FULL 

Not used 

if output is 
paper tape) 

Mot 

used. 

. FULLP 

Not used 



The . FULL and .FULLP pseuclo-ops cause full binary mode output to be 
produced. rF he program is assembled as unchecksummed. absolute code and 
each physical record of output contains nothing other than 18-bit 
binary storage words generated by the Assembler. This mode is used to 
produce paper tapes which can be loaded via hardware readj.n mode. 

If no address is specified in the .END statement or if the address 
value is zero, at the end of tape the Assembler will punch a FLT in- 
struction with channel 7 punched in the third frame. If the . END 
address value is non-zero, the Assembler will punch a JMP to that ad- 
dress, also with channel 7 of the third frame punched . 
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In addition, with .FULLP assembly direct memory references in page 1 
to addresses in page 1 will have bit 5 set to 0 unless indexing is 
specified . 

The only difference between the .FULL and .FULLP pseudo-ops is that 
memory references across page boundaries are flagged in .FULLP mode? 
in .FULL mode they are not. 

The following specific restrictions apply to programs assembled in 
.FULL or .FULLP mode output. 

.LOC Should be used only at the beginning of the program 

.BLOCK May be used once and only if no literals, variables or 
undefined symbols appear in the program, and must imme- 
diately precede .END. 

Variables and undefined symbols may be used if no literals or 
.BLOCKS appear in the program. 

Literals may be used only if the program has no variables, 

.BLOCKS, or undefined symbols. 

The reason for these restrictions, not alleviated by the use of .LTORG, 
is the fact that .FULL(P) mode output contains no addressing informa- 
tion for storing binary words other than in sequence. The .LOC and 
.BLOCK pseudo-ops do not generate binary output, hence there is no way 
to indicate skipped locations in the output. This is also true of 
variables and undefined symbols. 

3.2.3 Relocation Mode (.EEREL and . DBREL) 


Label Field 

Operation Field 

Address Field 

Not used 

. EBREL 

Not used 

Not used 

. DBREL 

Not used. 


The following two pseudo-ops ( . ERREL and .DBREL) enable relocation 
mode switching. They can be used anywhere and as often as the pro- 
grammer wishes in a relocatable program. In the absence of one of 
these mode declaration pseudo-ops, the page mode assembler assumes it 
is assembling 12-bit (page mode) relocatable addresses for memory 
reference instructions and the bank mode Assembler assumes 13-bit 
addresses (bank mode) . 
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A typical user program may omit the use of these pseudo-ops and simply 
prepare his object code by using the desired (bank or page mode) ver- 
sion of the Assembler. 

For XVM page mode programs which contain display code to be interpreted 
by the VT15 graphics processor, it is necessary to bracket the display 
code with .EBREL, -DBREL. Unlike the Central Processor, the VT15 
processor runs only in bank mode; hence its instruction addresses must 
be relocated as 13-bit values. 


Mnemonic 


Description 


.EBREL Enable Bank mode RELocation 

Regardless of the type of Assembler being used (bank or 
page mode version) , .EBREL causes all subsequent memory 
reference instruction addresses to be treated as 13-bit 
values, i.e., bank mode. Although in this mode, the 
page mode assembler will still output the "PR0G>4K" 
warning message if the program size exceeds 4096. The 
12- or 13-bit relocation is performed by the loaders. 
.EBREL signals the loaders to switch to 13-bit reloca- 
tion by causing a dummy data word (which is not loaded) 
to be inserted in the binary output and having a loader 
code of 31 . 

O 

.DBREL Disable Bank mode RELocation 

•DBREL is the counterpart to .EBREL. It signals the 
loaders, with a dummy data word (which is not loaded) 
and loader code of 32g to switch to 12-bit (page mode) 
relocation. 


NOTE 

The previous mode is not saved when an .EBREL or 
.DBREL is encountered; for this reason, a .DBREL 
pseudo-op goes directly to page mode relocation 
rather than entering the previous mode. 


3 . 3 TEXT HANDLING PSEUDO OPERATIONS 


The two text handling pseudo-ops enable the user to represent the 
7-bit ASCII or 6-bit trimmed ASCII character sets. The Assembler 
converts the desired character set to its appropriate numerical equiv- 
alent (see Appendix A) . 


Label Field 

Operation Field 

Address Field 

SYMBOL 

1 

f. ASCII ^ 
^.SIXET J 

» 

Delimiter - character 
string - delimiter - 
<expression> 
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Only the 64 printing characters (including space) may be used in the 
text pseudo-instructions. See nonprinting characters, Section 3 . 8 . 5 . 

The numerical values generated by the text pseudo-ops are left-justified 
in the storage word(s) they occupy with the unused portion (bits) of a 
word filled with zeros. 

3.3.1 IOPS ASCII Packed Format (.ASCII) 

.ASCII denotes 7-bit ASCII characters. (It is the character set used 
by the operating system monitor or executive.) The characters are 
packed five per two words of memory with the rightmost bit of every 
second word set to zero. An even number of words will always be out- 
put : 


First Word 

Second Word 

0 67 13 14 17 

023 9 10 16 17 

1st Char. 

2nd Char. 

3rd Char. 

4th Char. 

5th Char. 

0 


3.3.2 Trimmed Six-Bit Format (.SIXBT) 

. SIXBT denotes 6-bit trimmed ASCII characters, which are formed by 
truncating the leftmost bit of the corresponding 7-bit character. 
Characters are packed three per storage word. 


0 5 

6 11 

12 17 

1 st Char . 

2nd Char. 

3rd Char. 


3.3.3 .ASCII and -SIXBT Statement Syntax 

The statement format is the same for both of the text pseudo-ops. 
The format is as follows. 


MYTAG ■ 


H{;sixSH F ellmiter 


character string 


delimiter 


<expression> . 


3.3.4 Text Delimiter 


Spaces or tabs prior to the first text delimiter or angle bracket (<) 
will be ignored; afterwards, if they are not enclosed by delimiters 
or angle brackets, they will terminate the pseudo-instruction. 


3-9 





Pseudo Operations 


Any printing character may be used as the text delimiter, except those 
listed below. 

a. < as it is used to indicate the start of an expression. 

b. J as it terminates the pseudo-instruction. 

(The apostrophe (') is the recommended text delimiting character.) 

The text delimiter must be present on both the left-hand and the right- 
hand sides of the text string; otherwise, the user may get more char- 
acters than desired. 

3.3.5 Non-Printing Characters 

The octal codes for non-printing characters may be entered in .ASCII 
statements by enclosing them in angle bracket delimiters. In the 
following statement, five characters are stored in two storage words. 

-*| . ASCI I i_j ' AB ' <01 5> 'CD V 


Octal numbers enclosed in angle brackets will be truncated to 7 bits 
(.ASCII) or 6 bits (.SIXET). 


Example : 



Source Line 

Recognized Text 

Comments 

TAG -| 

. ASCII »__i ' ABC ' 

ABC 


H 

.SIXBTi_j' ABC' 

ABC 


H 

. SIXBTi— i 1 ABC 1 ti'/tt 

ABC ' / 

The # is used as a 
delimiter in order 
that ( 1 ) may be 
interpreted as 
text . 

H 

. ASCI I i__i 1 ABCD 1 EFGE 

ABCDFG 


H 

.ASCIIi— i' AB ' < 11> 

AP H 

<11> used to repre- 


. ASCII i — i ' AB <1 1 > ' 

AB <1 1> 

sent tab. There is 
no delimiter after 
B, therefore, 

(<11>) is treated 
as text. 

-H.ASCII 1 _|<15 x 01 2> 'ABC' 

VIabc 


-»j. ASCI I i_i <15 x 1 2>ABC i_j( s ) A 

y |BC i_i ( s ) 

A is interpreted as 
the text delimiter. 


The following example shows the binary word format which the Assembler 
generates for a given line of text. 
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Example: 

-H. ASCII H 'ABC' <015 « 12> 1 DEF 1 


Generated Coding 


Word Number 

Octal 

Binary 

Word 1 
Word 2 
Word 3 
Word 4 

406050 

306424 

422130 

600000 

1000001 

1000010 1000 

Oil 

0001101 

0001010 

0 

1000100 

1000101 1000 

110 

0000000 

0000000 

0 


3.4 MACRO DEFINITION PSEUDO-OPERATIONS (.DEFIN, .FTC, and . ENDM) 

The .DEFIN pseudo-op is used to define macros (described in Chapter 4) 
The address field in the .DEFIN statement contains the macro name, 
followed by a list of dummy arguments. If the list of dummy arguments 
will not fit on the same line as the .DEFIN pseudo-op, it may be con- 
tinued by means of the .ETC pseudo-op in the operation field and addi- 
tional arguments in the address field of the next line. The coding 
that is to constitute the body of the macro follows the .DEFIN state- 
ment. The body of the macro definition is terminated by an .FNDM 
pseudo-op in the operation field. (See Chapter 4 for more details on 
the use of macros.) 

3.5 COMMON BLOCK PSEUDO-OPERATIONS 

This class of pseudo-operations allows the programmer to define, 
reference and initialize FORTRAN-style COMMON blocks. Special Loader 
Codes are placed in the object output of the Assembler to allow the 
Linking Loader, CHAIN, or TKB to allocate memory for the specified 
COMMON blocks and link their addresses to transfer vectors in all pro- 
grams which reference them. Additionally, the programmer may specify 
the initial contents of the COMMON blocks (a facility similar to the 
FORTRAN BLOCK DATA function) . 

3.5.1 Common Block Definition (.CRD) 

The pseudo-op -CBD enables the programmer to declare a COMMON area of 
an indicated name and size and to specify the word to be set to its 
base address. The general format of this pseudo-op is: 
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Label Field 

Operation Field 

Address Field 

User Symbol 

.CBD 

Name, Size 


The • CBP pseudo-op takes a COMMON name and size as arguments, reserves 
one word of core for the base address, and outputs loader codes and 
parameters to direct the Linking Loader, CHAIN or TKB programs to set 
a transfer vector to the base address (first element) of the named 
COMMON array. For example, the statement: 

BASE-4 CBD-|ABCD , 6 

provides location BASE with the address of the first word of the 
COMMON area named ABCD whose size is 6. FORTRAN blank COMMON is 
given a special name by the system software, .XX. To reference blank 
COMMON in a .CBD statement, .XX should be given as the COMMON name. 

3.5.2 Common Block Definition -- Relative (.CBDR) 

The pseudo-operation .CBDR (common block definition relative) takes 
an offset as its only argument. The general format of this pseudo-op 
is : 


Label Field 

Operation Field 

Address Field 

User Symbol 

. CBDR 

Displacement 


This pseudo-op directs the Linking Loader, CHAIN or TKB to enter the 
starting address of the last COMMON block specified in a .CBD plus 
the offset given in the .CBDR into the word corresponding to the loca- 
tion of the .CBDR. 

For example, the statements 

BASE -) .CBD ABCD, 5 
BASE 3 H .CBDR-) 3 

will cause the task builder to enter the starting address of the 
COMMON block ABCD into the location corresponding to the tag BASE; 
in addition, the location corresponding to BASE 3 will contain the 
starting address of ABCD plus 3. 
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Note that . CBDR is relative to the last COMMON definition only. Any 
other assembler instructions or pseudo-operations may intervene 
between the .CBD and .CBDR. 

3.5.3 Common Block Initialization Start (.CBS) 

The pseudo-operation .CBS is used to prepare the Assembler to accept 
COMMON block initialization statements. The general format of this 
pseudo-op is: 


Label Field 

Operation Field 

Address Field 

Not used 

.CBS 

name [, size] 


The name parameter specifies the name of the COMMON block which is to 
be initialized, see description in .CBD (Section 3.5.1) for details 
regarding blank COMMON. The size parameter is optional, and if speci- 
fied represents the minimum size of the COMMON block. 

This pseudo-op, unlike .CBD or .CBDR does not generate a transfer 
vector, hence, a label on this operation is meaningless. After a .CBS 
instruction and up to the next .CBE instruction (i.e., between .CPS 
and .CBE operations) , the following rules apply to the type of state- 
ments which may be specified. 

1. .CBC statements are allowed. 

2. .DEC, .EJECT, .IFxxx, . ENDC , . LST, .NOLST, .OCT, .REPT, 

.TITLE, .DEFIN, . ENDM, .ETC are allowed. 

3. Macro instructions which generate only statements belonging 
to 1. or 2. above are allowed. 

4. Direct assignment statements are allowed. 

5. Machine instructions and transfer vectors are not allowed. 

6. Pseudo-operations other than those listed in 1 and 2 above 
are not allowed. 

7. Macro instructions which generate statements belonging to 
5 or 6 above are not allowed. 


Example : 


— |.CBS -»| ABCD , 6 
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indicates that a COMMON block named ARCD with a minimum length of 
6 words is to be initialized by statements which follow. 

3.5.4 Common Block Initialization Constant (.CBC) 

The .CBC statement is used to initialize a single word of the COMMON 
block declared in the preceding .CBS statement. The format of the 
.CBC statement is: 


Label Field 

Operation Field 

Address Field 

Not used 

.CBC 

Displacement, Constant 


The displacement parameter specifies the offset from the start of the 
COMMON block of the word to be initialized. The constant parameter 
is an absolute expression, the value of which will be used as the ini- 
tial contents of the specified word in the COMMON block. If the .CBC 
statement is used outside the -CBS - . CBF instructions, it is flagged 
and ignored by the Assembler. If a .CBC statement is preceded by a 
.REPT statement which has a non-zero increment, the data will be in- 
cremented, and the displacement will be incremented by one. Therefore, 
the data generated will be placed in succeeding locations in common. 

Example : 

■CBC 2,4 

will set the third word (base address+2) of the COMMON block specified 
by the preceding .CBS to the initial value of 4. 

3.5.5 Common Block Initialization End (.CBE) 

The .CBE pseudo-op is used to terminate the COMMON block initialization 
section initiated by the .CBS operation. The general format is: 


Label Field 

Operation Field 

Address Field 

Not used 

-CBE 

Not used 


A COMMON block initialization section (consisting of one .CBS followed 
by one or more .CBC's followed by a .CBE) may appear anywhere in a 
program without affecting the flow of the object program. Also, the 
same COMMON block may be initialized any number of times by any number 
of programs. 
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3.6 CONDITIONAL ASSEMBLY ( . IFxxx and . ENPC ) 

It is often useful to assemble some parts of the source program on an 
optional basis. This is done in MACRO by means of conditional assem- 
bly statements, of the form: 

-*|. IFxxx expression 

The pseudo-op may be any of the eight conditional pseudo-ops shown 
below, and the address field may contain any number, symbol, or expres- 
sion. If there is a symbol, or an expression containing symbolic ele- 
ments, such a symbol must have been previously defined in the source 
program or the parameter file (except for .IFDEF and . IFUND) . If not, 
the value of the symbol or expression is assumed to be 0 , thereby 
satisfying three of the numeric conditionals. 

If the condition is satisfied, that part of the source program starting 
with the statement immediately following the conditional statement and 
up to but not including an .ENDC (end conditional) pseudo-op is assem- 
bled. If the condition is not satisfied, this coding is not assembled. 

The eight conditional pseudo-ops (sometimes called IF statements) and 
their meanings are shown below. 


Pseudo-op 

Assemble IF x is: 

-\ . IFPNZujX 

Positive 

and non-zero 

-*) . IFNEGi_jx 

Negative 


-*) . IFZERi_ix 

Zero 


-*| . IFPOZi ix 

Positive 

or zero 

H.IFNOZu-iX 

Negative 

or zero 

H . IFNZRi ix 

Not zero 


-*j . IFDEF i_ix 

A defined 

. symbol 

-*| . IFUNPujx 

An undefined symbol 


In the following sequence, the pseudo-op . IFZER is satisfied, and the 
source program coding between .IFZER and .ENDC is assembled. 
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1 



v DEC 

2 

000060 A 

SUi 

.< f OT-48 

3 

000060 A 

nr 

"ALL-48 

4 

5 00000 

2 0 0 0 0 2 ft 


•> .1. }•• /. 1::. ft! U B f U 1 -• i 

LAC A 

6 ooooi 

1' 040003 R 


l.i AC B 

7 



, ENDC 

8 00002 

R 000000 A 

A 

0 

9 00003 

R 000000 A 

B 

0 

10 

000000 A 


, END 

SIZE =00004 NO 

ERROR LINES 



Conditional statements 

may be nested 

. 

For each IF statement 


must be a terminating .ENDC statement. If the outermost IF statement 
is not satisfied, the entire group is not assembled. If the first IF 
is satisfied, the following coding is assembled. If another IF is 
encountered, however, its condition is tested, and the following coding 
is assembled only if the second IF statement is satisfied. Logically, 
nested IF statements are like AND circuits. If the first, second, and 
third conditions are satisfied, then the coding that follows the third 
nested IF statement is assembled. 

Example : 


I 

000000 A 

X X 0 








* IEP0Z 

y v 

/C0ND. .!. INI"! 

I aTQR 

3 

00000 R 200002 R 


LAC 

TAG 



4 

n 



* IFNZR 
DAC 

1 

TAG! 

/CONJD* 2 INI'i 

TAiOR 


00001 R .1.00002 R 


., ENDC 
JMS 

T AG 



8 



, ITDEF 

Z 

/C0ND. 3 INI! 

1 A ! 0 R 

9 



DAC 

TAG2 



1.0 



* ENDC 


/CONDt 3 "s ERi 

1INAT0R 

.1. 1 



. ENDC 


/CGND , 1 TER!' 

1 1N A TOR 

1. 2 

000000 A 

Y = 0 





.1 3 

00002 R 740000 A 

TAG 

MOP 




:l. 4 

00003 R 740040 A 

TAG! 

Hi... T 





Conditional statements can be for a variety of purposes. One of the 
most useful is in terminating recursive MACRO calls (described in 
Chapter 4) . In general, a counter is changed each time through the 
loop, or recursive call, until the condition is not satisfied. This 
process concludes assembly of the loop or recursive call. 
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3.7 LOCAL SYMBOLS (.LOCAL AMD . NDLOC) 


Label Field 

Operation Field 

Address Field 

Not used 

. LOCAL 

Not used 

Not used 

. NDLOC 

Not used 


The size of a program that can be assembled with the Assembler is 
determined by the number of user symbols in that program and therefore 
by the amount of core available at assembly time in which to store 
those symbols. Each user symbol requires three words of core in the 
assembler's symbol table. This additional core is not required at 
run-time (unless using a debugging program like DDT) because user 
symbols are not loaded into core along with the object code. 

The .LOCAL and .NDLOC pseudo-ops enable deletion of certain symbols 
from the user symbol table. In so doing, larger programs can be assem- 
bled without increasing core size. The area between these two pseudo- 
ops is defined as having a number of symbols, most of which are used 
only in this area and which can be deleted, once this area has been 
passed by the Assembler. 

The Assembler creates a separate symbol table (local users symbol 
table) when the .LOCAL pseudo-op is encountered. Only labels and 
direct assignments may be stored in this table. Labels which have 
the # sign as part of the symbol are stored in the resident users 
symbol table (RUST) . This feature is useful where a subroutine name 
is part of a local area but must go into the RUST because of subroutine 
calls from without the local area (see Section D of the following 
example) . Symbols which are forward references (used before defined) 
are stored as part of the resident users symbol table. When the 
.NDLOC pseudo-op is encountered the local table disappears and the 
resident UST is left unchanged. 

An example of a program which uses the .LOCAL and .NDLOC pseudo-ops 
follows. The symbols that are stored in the tables are represented 
in the comment field in the order that they are stored during PASS 1. 
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00100 



, I..0C 

100 


3 


001 00 

703302 


CAP 



4 


00 . 1.01 

1001 1 1 


J M 8 

IT YIN 


5 


00102 

600137 

A 

JMP 

C 


u 


00103 

777770 


LAW 

- 1 0 


/' 


00104 

040140 


OAC 

D 


8 


00105 

44014 • 

KK 

IS 2 

D 


Q 


0 0 .!. 0 w 

6 0 0 ;!. 0 2 


v ' M 

A 


:!. 0 


00 1 07 

200 :!. 05 


LAC 

K K 


. 1 . i 
1 


00 :!. 1 0 

600.1, 27 


JiiP 

A A 


.1.3 





. LOCAL 



j 4 


00111 

0 0 0 w* 0 0 

TTY IN 

0 


/ At. R £ A Li Y S T 0 R E D 1 N 

1 5 







/K'UJI i" Ki.Ji'i i. . 1 . iN icf A* 

16 


001 12 

600 1 .!. 7 


JMP 

1 c 

V T \J 


.1. ? 


00113 

000000 

XXX 

0 


/TEMP « STORAGE OF 

18 


00114 

0 () () (} Q Q 

YY 

0 


/5LJ6R* 7 TY.T.N 

19 


00113 

000000 

7 

0 



20 

p 

00 1 1 6 

000000 

X 1 

0 



'1 •! 

l { 

00 1 1 7 

000142 


!\ .:> i" 



2 2 


00120 

600117 


JMP 

* - ;l. 


23 

u 

00121 

000 :l. 4 :i. 


KRB 



24 


00122 

040:1,13 


DAC 

XXX 


25 


00123 

0 4 0 1 1 4 


DAC 

YY 


26 


00.124 

0401 IS 


:o a c 

/. 


p "/ 

IJ 

00 .i. 25 

040143 


LAC 

XI 


28 


00126 

6201 11 


: jjt 

TTYIN 


29 





♦NDLOC 



3 :!. 

u 

00127 

200143 

A A 

LAC 

X 1 

/ F 0 R U A R P R L F E R E N C E 

3 2 


00 1 2 0 

6001 05 


JMP 

KK 


5 
















34 





■> LOCAL 



35 


00131 

000000 

SYMl 

0 


/TEMP. STORAGE OF 

36 


00132 

000000 

8YM2 

0 


/SUBE. TSUBR 

37 


00133 

000000 

rSUBR* 

0 


/NOT LOCAL? DUE TO 

?.q 


00134 

200131 


LAC 

8 Y M 1. 


39 


00.1.33 

0401 32 


UAL 

i :' Y j v j 2 


40 


00136 

620133 


JMP* 

TSl'Bft 


4 :!. 





. NDLOC 



4 




/ 








•• 




43 


00137 

000001 

fj 

1 



44 


00 1 40 

0 0 0 0 0 2 

n 




4 5 



060000 


„ END 






3-18 



Pseudo Operations 


For purposes of illustration, lines 1-11, 12-26, 27-29, and 30-36 are 
broken into sections A, B, C, and D respectively. The following 
tables show the resident and local users symbol tables (UST) at the 
end of each section (PASS 1 only) . 

RESIDENT UST 


SECTION A 
A 

AA 

C 

D 

KI< 

TTY IN 
SECTION B 

A 

AA 

C 

D 

KK 

TTY IN 
SECTION C 

A 

AA 

C 

D 

KK 

TTY IN 
XI 

SECTION D 
A 

AA 

C 

D 

KI< 

TTY IN 
XI 

TSUBR 


LOCAL UST 


(NO SYMBOLS) 


X 

XI 
Y 
Z 


(NO SYMBOLS) 


SYM1 

SYM2 


In Section A, the symbol TTYIN is used. TTYIN is in a local area yet 
it is put into the resident user symbol table because it is a forward 
reference. The same is true of symbol XI from Section C. Once the 
.NDLOC pseudo-op is encountered, the local UST no longer exists. For 
that reason, the XI reference from line 28 is a forward reference. 

At the end of PASS 1, XI would be represented as an undefined symbol. 
When Section B is processed during PASS 2, the symbol XI would not be 
stored in the local UST because it already has been put into the 
resident table. 
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LIMITATIONS 

The -LOCAL pseudo-op causes the local UST to be built just above the 
macro definitions. Consequently, the -DEFIN pseudo-op is illegal in 
a local area. 

3.8 LITERAL ORIGIN ( . LTORG) 


Label Field 

Operation Field 

Address Field 

Not used 

.LTORG 

Not used 


As previously stated, a literal is an item of data with its value as 
stated or listed. The pseudo-op .LTORG allows the user to specifically 
state where he wants his literal table (s) to be stored; thus enabling 
the user to store literal tables in different pages or banks. As 
many as eight literal tables are allowed. Notice in the following 
example that literals are not saved from one .LTORG to the next. 



The literals 1 and 2 are stored twice even though they appear in the 
same bank. 

If more than eight .LTORG statements appear in a program, the excess 
ones will be ignored and flagged with an 1 error. Subsequent literals 
will be assigned core locations following the end of the program in 
the normal manner . 
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3.9 SETTING THE LOCATION COUNTER (.LOC) 


Label Field 

Operation Field 

Address Field 

Not used 

.LOC 

defined expression 


The .LOC pseudo-op sets or resets the location counter to the value of 
the expression contained in the address field. The symbolic elements 
of the expression must have been defined previously; otherwise, phase 
errors will occur in PASS 2. The .LOC pseudo-op may be used anywhere 
and as many times as required. 

Examples : 



A program headed by an absolute statement, e.g., .I,OC 100 is an ab- 
solute binary program and the binary is output in link-loadable format. 


3.10 RADIX CONTROL (.OCT and .DEC) 


The initial radix (base) used in all number interpretation by the 
Assembler is octal (base 8) . In order to allow the user to express 
decimal values, and then restore to octal values, two radix setting 
pseudo-ops are provided. 
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Pseudo-op Code 

Meaning 

• OCT 

Interpret all succeeding numerical values in 


base 8 (octal) 

• DEC 

Interpret all succeeding numerical values in 


base 10 (decimal) 


These pseudo-instructions must be coded in the operation field of a 
statement. All numbers are decoded in the current radix until a new 
radix control pseudo-instruction is encountered unless the pseudo-op 
occurs within a macro expansion (see Section 4.2). The programmer 
may change the radix at any point in a program. 



1. 

']> 

3 

4 


SIZE -00004 


00000 E: 007303 A 

0 00 0 1. R / 7 7 7 7 3 A 

00002 R 003347 A 

00003 R 007303 A 

000000 A 
.1 ERROR LINES 


* DEC 
3779 
■> : ): I- 'i 

33-47 

. END 


' 1. I Li., MAL . 


/DECIMAL A 


If a number is encountered which contains a decimal digit while in 
octal mode, the number is evaluated as if the Assembler were in decimal 
mode, and the line is flagged with an N. 

3.11 RESERVING BLOCKS OF STORAGE (.BLOCK) 

.BLOCK reserves a block of memory equal to the value of the expression 
contained in the address field. If the address field contains a 
numerical value, it will be evaluated according to the radix in effect. 
The symbolic elements of the expression must have been defined pre- 
viously, i.e., no forward referencing is allowed; otherwise, phase 
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errors might occur in PASS 2. The expression is evaluated modulo 
2* " (77777g) . The user may reference the first location in the block 
of reserved memory by defining a symbol in the label field. The 
initial contents of the reserved locations are unspecified. 


Label Field 

Operation Field 

Address Field 

User Symbol 

. BLOCK 

defined expression 


Examples : 

BUFF -»| .BL0CKi_,12 J 

-*| .BLOCKi_iA+B+65j 

3.12 END OF PROGRAM (.END) 

One pseudo-op must be included in every source program. This is the 
.END statement, which must be the last statement in the main program. 
This statement marks the physical end of the source program, and also 
may contain the location of the first instruction in the object pro- 
gram to be executed at run-time. 

The .END statement is written in the general form 
— |. ENDi_iSTARTy 

START may be a symbol, number, or expression whose value is the addres 
of the first program instruction to be executed. In relocatable pro- 
grams to be loaded by the Linking Loader, CHAIN or TKE, only the main 
program requires a starting address; all other subprogram starting 
addresses, if specified, will be ignored. 

A starting address may appear in absolute or self-loading programs; 
if not, the program will halt after being loaded and the user must 
manually start his program. 

These are legal .END statements 

— j. FND»_jBEGIN+5y 
-*). ENDi_i200y 

If no .END statement is included, the Assembler will treat it as if 
a .EOT was included. 
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3.13 END OF PROGRAM SEGMENT (.EOT) 

If a program is physically segmented (on paper tape, disk, DECtape or 
magtape), each segment except the last may terminate with an .EOT (end- 
of-tape) statement or with nothing at all (neither .EOT nor .END). 
Termination with nothing is equivalent to termination with .EOT. The 
last segment must terminate with an .END statement. The .EOT state- 
ment is written without label and address fields, as follows, 


-*|.EOTj 

The following are typical reasons for segmenting programs: 

1. A source program is prepared on three different paper tapes 
because one tape alone would be too large to fit in the 
reader . 

2. A source program is split in two and stored on two DECtapes 
because it is larger than the capacity of a single tape. 

3. To simplify program preparation, a disk file containing 
commonly used macro definitions is kept physically separate 
from user main programs. Thus, one does not have to include 
the macro definitions in each main program. 

4. Programs can be conditionally assembled for different machine 
configurations or different software options. This is done by 
defining conditional assembly parameters at assembly time. 

The process can be simplified if one prepares paper tapes or 
mass storage files defining all parameters for a given set of 
options. The main program and parameter file are physically 
segmented one from the other but can be assembled together. 

3.14 GLOBAL SYMBOL DECLARATION ( .GLOBL) 


Label Field 

Operation Field 

Address Field 

Not used 

.GLOBL 

symbol [, symbol . . .] 


The standard output of the Assembler is a relocatable object program. 
The Linking Loader, CHAIN or TKB joins relocatable programs by supply- 
ing definitions for global symbols which are referenced in one program 
and defined in another. The pseudo-op .GLOBL, followed by a list of 
symbols, is used to define to the Assembler those global symbols which 
are either 
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a. internal globals - defined in the current program and refer- 
enced by other programs 

b. external symbols - referenced in the current program and de- 
fined in another program 

The loader (Linking Loader, CHAIN or TKB) uses this information to 
include in the load and then link the relocatable programs to each 
other . 

All references to external symbols must be indirect references since 
XVM software systems use transfer vectors for referencing external 
symbols. Each external symbol causes an additional word (the transfer 
vector word) to be reserved in the user program. The loading pro- 
gram will store the actual address of the external symbol in the trans- 
fer vector word. Thus, an indirect reference (through the transfer 
vector) will cause the external symbol location to be addressed. 

Example: 


-*) . GLOBL H A, B, C 


A-*) LAC 

H D 

/A is an internal 

global 

D-»| JMS* 

H B 

/These two instructions reference 

H JMS* 

H c 

/External symbols 

indirectly 

.END 

H o 




The .GLOBL statement may appear anywhere within the program. 
The example above is assembled as follows: 


I. 


=00007 





000004 R 
ft 000005 E 
R 000 006 £ 
ERROR I... 1 ME 




! .. A L 


The real values for locations 3 and 4 will be supplied by the loading 
program: these two words will contain the addresses in memory of 

external symbols B and C. 
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3.15 REQUESTING AN I/O DEVICE HANDLER . IODEV (Not supported in XVM/ 
RSX) 

The .IODEV pseudo-op appears anywhere in the program and is used to 
cause the Assembler to output code for the Linking Loader or CHAIN 
which specifies the slots in the Monitor's device assignment table 
(DAT) whose associated device handlers are required by the program. 
This is used in XVM/DOS where device handlers are brought into core 
at the time a program is loaded to run. 


Label Field 

Operation Field 

Address Field 

Not used 

.IODEV 

datslot £ , datslot . . .] 


The arguments may be numeric or symbolic. If the argument is symbolic, 
the symbol must be defined by a direct assignment statement. 

3.16 DESIGNATING A SYMBOLIC ADDRESS ( . DSA) 

.DSA (designate symbol address) is used in the operation field when 
it is desired to create a word composed of just a transfer vector 
(17-bit address) . It is useful when a user tag symbol is also a 
permanent instruction or pseudo-op symbol. 


Label Field 

Operation Field 

Address Field 

User Symbol 

.DSA 

expression 


Examples : 


JMP LAC H TAG 
.DAS H JMP 
-j -*j JMP 


Equivalent methods of designating the user 
symbol JMP (rather than the instruction JMP) 
to be in the address field. 


3.17 REPEAT OBJECT CODE (.KEPT) 


Label Field 

Operation Field 

Address Field 

Not used 

. RFPT 

count [.increment] 


The .REPT pseudo-op causes the object code of the next sequential 
object code generating instruction to be repeated "count 1 ' times. 
Optionally, the object code may be incremented for each time it is 
repeated by specifying an increment. The count and increment may be 
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represented by a numeric or symbolic value. If a symbol is used, it 
must be defined by an absolute direct assignment statement which must 
occur before the symbol is used. The repeated instruction may contain 
a label, which will be associated with the first statement generated. 
Note that arithmetic expressions in the increment field are illegal. 

Examples : 


o 

0 0000 !" 

S 0 0 ' 

:) o 0 0 A 


0000.1. !• 

‘ 0 0 ( 

3000 A #! 


00002 i :; 

i: 00-; 

>000 A #| 


O000'3 !• 

■■ o 0 '• 

[) 0 0 0 A #i 


0 0 0 0 4 S’ 

'< 00* 

') 0 0 0 A ¥ . 

A 

OOO05 [ 

? o o i 

DO 01 A 


0 0 0 0 7 F 

oo 

0003 0 # 

5 

0 0 0 'I 0 S’ 

v 0 0 1 

0 0 0 4 A >;< 

0 0 l 1 K 

6 

'/ 

00“ vu. 1 

■* 40* 

0011 R 


0 0 *- ' 1 2 S 
00013 i 

60 

R ¥ 


00014 : 

\ 6 \) 

0 0 1 4 R ¥ 

8 


r« o 

0 0 ( ) 0 A 


NOTE 

If the statement to be repeated generates more than 
one location of code, the .RFPT will repeat only the 
last location. For example, 

-|.RFPTi_j3 

ASCII 1 A ' 

will generate the following: 

404000 5/7 A 

000000 

000000 last word is 

000000 repeated 
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3.18 REQUEST PROGRAM SIZE (.SIZE) 


Label Field 

Operation Field 

Address Field 

user symbol 

.SIZE 

not used 


When the assembler encounters .SIZE, it outputs one word which contains 
the address of the last location plus one occupied by the object pro- 
gram. This is normally the length of the object program (in octal) . 
However, if a given program is 121 words long and has a .LOC 400 

O 

statement at the head of the program, the value of the .SIZE word will 

be 521_. 
c 


3-28 




CHAPTER 4 
MACROS 


When a program is being written, it often happens that certain coding 
sequences are repeated several times with only the arguments changed. 
It would be convenient if the entire repeated sequence could be gen- 
erated by a single statement. To accomplish this, it is first nec- 
essary to define the coding sequence v/ith dummy arguments as a macro 
instruction, and then use a single statement referring to the macro 
name along with a list of real arguments which will replace the dummy 
arguments and generate the desired sequence. 

Consider the following coding sequence. 

H LAC -*l A 

H TAD B 
DAC -| C 


-| LAC-*j D 
H TAD -| E 
H DAC -»| F 


The sequence 

H LAC-*| x 
-*| TAD-*| y 
H DAC-*) z 

is the model upon which the repeated sequence is based. The characters 
x, y, and z are called dummy arguments and are identified as such by 
being listed immediately after the macro name when the macro instruc- 
tion is defined. 
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4.1 DEFINING A MACRO 

Macros must be defined before they are used. The process of defining 
a macro is as follows. 

(Macro ^Name) (Dummy Arguments) 
(Definition Line) -*| .DEFIN-*) MACNME, ARG1 fARG2^ARG3-»| /comment 

LAC HARG1 
(Body) -| TAD -|ARG2 

HdAC HARG3 
(Terminating Line) -*J . F.NDM 

The pseudo-op .DEFIN in the operation field defines the symbol follow- 
ing it as the name of the macro. Next, follow the dummy arguments, 
as required, separated by commas and terminated by any of the following 
symbols . 


a . 

space 

<u-j) 

b. 

tab 

H ) 

c . 

carriage return 

( , ) 


The macro name and the dummy arguments must be legal assembler symbols. 
Any previous definition of a dummy argument is ignored while in a 
macro definition. Comments after the dummy argument list in a defini- 
tion are legal. 

If the list of dummy arguments cannot fit on a single line (that is, 
if the .DEFIN statement requires more than 72 ^q characters) it may be 
continued on the succeeding line or lines by the usage of the .ETC 
pseudo-op, as shown below. 

-•) DEFINH MACNME, ARG1 , ARG2 , ARG3 /comment 
-*| . ETC -*|ARG4,ARG5 /argument continuation 


-•1 . DEFIN -*| MACNME 

— |.etc 

— ] ARG1 

—(.ETC 

-)ARG2 

-»| . ETC 

— |ARG3 

H .ETC 

-•) ARG4 

-•1 . ETC 

-*|ARG5 
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4 . 2 MACRO BODY 

The body of the macro definition follows the . DEFIN statement. Appear- 
ances of dummy arguments are marked and the character string of the 
body is stored, five characters per two words in the macro definition 
table, until the macro terminating pseudo-op . ENDM is encountered. 
Comments within the macro definition are not stored. 


Dummy arguments may appear in the definition lines only as symbols or 
elements of an expression. They may appear in the label field, opera- 
tion field, or address field. Dummy arguments may appear within a 
literal or they may be defined as variables. They will not be recog- 
nized if they appear within a comment. 

The following restrictions apply to the usage of the .DEFIN, .ETC and 
.ENDM pseudo-ops: 

a. If they appear in other than the operation field within the 
body of a macro definition, they will cause erroneous results. 

b. If .ENDM or .ETC appears outside the range of a macro defini- 
tion, it will be flagged as undefined. 

If index register usage is desirable, it should be specified in the 
body of the definition, not in the argument string. 


.DEFIN 
LAC A 
DAC B, X 
LAC C 
. ENDM 


XUSE, A, B, C 


If .ASCII or .SIXBT is used in the body of a macro, a slash (/) or 
number sign (#) must not appear as part of the text string or as a de- 
limiter (use < 57 > to represent a slash and < 43 > to represent a number 
sign) . Be careful when using a dummy argument name as part of the 
text string. For example. 


.DEFIN 
.SIXBT 
.SIXBT 
. ENDM 


TEXT A 
! A, 

.A. 
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followed by the macro call, 

TEXT XYZ 

will generate the following code 

. SIXBT , XYZ , 

. SIXBT .A. 

In the first .SIXBT statement, A is recognized as a dummy argument re- 
sulting in the substitution of XYZ. In the second statement, A is not 
recognized as a dummy argument because the string delimiter, period, 
is itself a legal symbol constituent. 

Definition Comments 

-*) .DEFIN H MAC ,A,B,C,D,E,F 

H LAC H A# 

-*| SPA 

H JMP H B 

HlSZ -»| TMP /E E is not recognized as an argument 

Hlac -*) (C 

Hdac H D + 1 

Hf 

H .ASCII H E 
B= . 

. ENDM 

4 . 3 MACRO CALLS 

A macro call consists of the macro name, which must be in the operation 
field, followed by a list of real arguments separated by commas and 
terminated by one of the characters listed below. 

a. space (»— • ) 

b. tab (-*1 ) 

c . carriage ( ) ) 
return 

If the real arguments cannot fit on one line of coding, they may be 
continued on succeeding lines by terminating the current line with a 
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dollar sign ($) . When they are continued on succeeding lines they must 
start in the label field. 

Example : 

HmAC-*|REAL1 , REAL 2 , REAL 3 , $ 

REAL4 , REAL5 

If there are n dummy arguments in the macro definition, all real argu- 
ments in the macro call beyond the nth dummy argument will be ignored. 

A macro call may have a label associated with it; this label will be 
assigned to the current value of the location counter. 

Example : 




7 AD 
BAC 

v 




00000 R START 

00000 ft 200006 R JfcG 
0 0 0 0 :!. ft' 3 4 0 0 1 1 R & G 
0 0 0 0 2 ft 0 A 0 0 0 4 ft >k ( ’ 


0 A a o 3 !■ 

00004 *■ 


■< 200007 ft 4--G 
C 4 0 V J. 0 ft 


00005 ft 040007 R >K fv 


i’ 7 f ,f\ t \ t. ) I i i v i f » i } i.'.) 

0 0 •' ft () 0 0 1 : 7 . ' i- ‘ 
jO.IO i :; : 00C006 A 
C C) A 


. i n * • ft ft (' 


I • T' I... 


UP DAT E 
LAC 

i ’ •) D 

ft AC 

UPDATE 

LAC 

TAD 

f i A C 




CNTft 

Cf'Tft 


A y H 


The prevailing radix will be saved prior to expansion and restored 
after expansion takes place. Default assumption will be octal for the 
macro call. It is not necessary for the macro definition to have any 
dummy arguments associated with it. 


Example: 





hrC 



3 



A 



4 



CHL 




OOO'jO 

ft 200003 ft 

, ENBM 
LAC 

A L i" 

'HA 

8 

00001 

ft 723023 A *G 

AD 023 

2 3 



00002 

R 741100 A #6 

8 ft A 




00003 

R 740002 A % G 

wh 



Q 

i \ A ( 'f 0 A 

ft 0 4 0 0 0 K 

BAC 

ALr 

■HA 

1 0 






1 1 

00005 

R 000367 A ALP 

HA 367 



12 

06 NO 

0 0 0 0 0 0 A 

- ENG 



6 .1. Z L 0 0 0 

ERROR LINES 
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4.3.1 Argument Delimiters 

It was stated that the list of arguments is terminated by any of the 
following symbols. 


a . 

space 

(*-») 

b. 

tab 

H) 

c . 

carriage return 

( ) 


These characters may be used within real arguments only by enclosing 
them in angle brackets (<>). Angle brackets are not recognized if 
they appear within a comment. 

Example : 

3 JAb » 


O 


7 



MAC 

X X !•' 


00000 

R 200007 R >KG 

LAC 

XX 


00001 

\ < 3 A 0 0 1 0 R 2 G 

TAD 

Y Y 



::: 040*0*11 R '¥• 

DAC 

7 7 


V'J'J J.v.. 




8 

9 



MAC 

XX ^ 

0 



I AO ' 

Z 


00003 

K 200007 K 

LAC 

XX 


00004 

E 3400:1.0 R #3 

: AD 

YY 


00005 

R 740030 A HtG 

.1 AC 



0 0 0 0 6 

R 040011 R >KB 

DAC 

ZZ 


.!. .1 


3 






4 

00 ( 

07 r 

; 000123 A 

XX 

<■ DS 

5 

oo< 

10 i : 

: 000065 A 

Y Y 

■> D8 

o 

00< 

i i i 

• 0 0 0 0 0 0 A 

X Z 

v D£ 

7 



000000 A 


v !" N 


S I Z E 0 0 0 1 2 N 0 E E E OR !... . 1 . N E S 


All characters within a matching pair of angle brackets are considered 
to be one argument, and the entire argument, with the delimiters (<>) 
removed, will be substituted for the dummy argument in the original 
definition. 

The Assembler recognizes the end of an argument only on seeing a ter- 
minating character not enclosed within angle brackets . 

If brackets appear within brackets, only the outermost pair is deleted. 
If angle brackets are required within a real argument, they must be 
enclosed by argument delimiter angle brackets. 

Example : 



■> U J.H 

C.KK 

! !•::> U I l::.A ! 


5 

. ASCI I 

TRX 

y . ) 
T 


4 

6 

. EN'DM 

ERKMbG 

•x / !1 

RR0R IN 1. 

..IMF 
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U 00000 R 600007 R #G 
0000:1 R‘ 426452 A >KG 

00002 R 247644 A *G 

00003 R 202231 A #G 

00004 R 620230 A YG 

00005 R 446550 A '4 G 

00006 R 506400 A &G 

7 0 0 0 0 0 0 A 

ZE® 00 0:1.0 :l. ERROR LINES 

4.3.2 Created Symbols 

Often, it is desirable to attach a label to a line of code within a 
macro definition. As this label is defined each time the macro is 
called, a different symbol must be supplied at each call to avoid 
multiply defined symbols. 

This symbol can be explicitly supplied by the user or the user can 
implicitly request the Assembler to replace the dummy argument with a 
created symbol which will be unique for each call of the macro. For 
example, 


,.JMP 


-|.definHmac,a, ?B 

The question mark (?) prefixed to the dummy argument 3 indicates that 
it will be supplied from a created symbol if not explicitly supplied 
by the user when the macro is called for. 

The created symbols are of the form . . 0000-*-. . 9999 . Like other symbols, 
they are entered into the symbol table as they are defined. 

Unsupplied real arguments corresponding to dummy arguments not preceded 
by a question mark are substituted in as empty strings; and supplied 
real arguments corresponding to dummy arguments preceded by a question 
mark suppress the generation of a corresponding created symbol. 

Example : 

1 
o 

3 

4 

6 
8 
:l 0 


.> DEF I N MAC > A •/ B •> ?C t ?D v ?E 


JAF- 
FA C 
DAC 
DAC 


% ENDM 
MAC 


Y# s f ? ? MY TAG 
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00000 

R 200007 

R 


LAC 

Y* 


00001 

R 740200 

A 


SZA 



00002 

R 600006 

E 


JMP 

. . 0003 


00003 

R 200000 

A 


LAC 



00004 

R 040010 

R 


DAC 

. * 00021 


00005 

R 040006 

R 

JUG 

DAC 

MYTAG 



000006 

R 

*G . *< 

)003~ * 


11 




/ 



12 

00006 

R 000000 

A 

MY' 

"AG 0 


13 


000000 

A 


. END 


ZE-000 1 1 

NO 

ERROR L :i: i 

JE! 





If one of the elements in a real argument string is not supplied, that 
element must be replaced by a comma, as in the call above. A real argu- 
ment string may be terminated in several ways as shown below: 

Example : 


MAC 

A B > l_J 

MAC- 

A ? B i i ) 

MAC 

A v B i_i 

MAC 

A y B J 

MAC 

A * B ? ) 


4.3.3 Concatenation 


If a dummy argument in a definition line of the macro body is delimited 
by the concatenation operation and immediately preceded or followed 

by other characters or another dummy argument, the characters that cor- 
respond to the value of the dummy argument (real argument) are combined 
(juxtaposed) in the generated statement with the other characters or 
the real argument that corresponds to the other dummy argument. This 
process is called concatenation. 

The following example illustrates this operation. 


1 




vBfci- IN 

CALL v TYP 

E » ADD 

•;> 




J MC TYPE 

A DDR 


3 




<- ENBM 



4 



/ 




5 




CALL 

P J ECU': .!. 



00000 

R 600003 R &G 


JMP 

ROUT 1 


6 







7 




CALL 

S t CSUBRT 

i 

8 




* USA 

ABO 



0000 1 

R 100004 R *G 


JMS 

SUBRT1 



00002 

R 000005 R #G 


v DBA 

ABC 


9 



/ 




10 

00003 

R 740040 A 

ROUT.!. 

:<X 



11 

00004 

H OOuwQO A 

SUBET1 

Q 



1 2 

00005 

R 000000 A 

ABC 

Q 



13 


0 0 0 0 0 0 A 


, END 



ZE" = 00006 

NO 

ERROR LINES 
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The dummy argument TYPE is used to vary the mnemonic operation code of 
the generated statement. The character P, which is the corresponding 
value of TYPE in the first call to the macro, will be concatenated with 
the characters JM to form the mnemonic JMP . This action occurs because 
a dummy argument (i.e., TYPE) is delimited by the concatenation opera- 
tor (i.e., is preceded by @ and is immediately preceded or followed 
by other characters or another dummy argument) . 


Of course, in the case where other characters are to be concatenated 
with the value of a dummy argument, and the first of the other chara- 
cters is a delimiter, it is not necessary to further delimit the dummy 
with the concatenation operator. The following example illustrates 
this rule. 


3 

4 


6 

7 


. 1. 0 
. 1.1 
12 
1 3 


* DEFIN 
. IFZLR 
SN'P 

SV . :?i...Vl... » BLOCK 
SVC « P i... VL."” 

<• ENDC 
DAC 
LAC 
DAC 

♦ ENDM 

000000 A SVC . 0™0 

00 Ou 00 A SVC *1*0 


MOVE » FROM >■ '1 0 * LVi 
SvC * if? I .. V L. 

:l. 


SO . CL.. 0 L 
FROM0LVL >• X 
TO CL VI... v X 
SO , 21 ... vl... 

/MUST DEFINE 1 FOR EACH LEVEL 
/ CALLED IN ' MOVE ' . 


.1.5 


17 


1 9 
20 


/ 


00000 
0000 i 


00002 
C 0 0 0 ■■■• 
00004 
0000 :i> 


741000 A JjStj 
A :*i- 
OOOOo i. A *C 
.?• G 

0 - : 01 R *£i 

21 0020 A >K;j 

030. >2 j. R 
200001 R >KG 




LAC UST0>X 
DAC US TO » X 



: K 1 ' !*;• 



000 1 2 R 741000 A 



00 Old R 05 0025 R :4G 
( > 0 0 :i. 7 R 2 0 0 0 1 3 R * G 


MOVE 



DA C BJ. yX 

i... A S V .. 
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In this example concatenation is used to test the existence of a named 
temporary location, and, if necessary, output code to define it. Then 
the concatenation operator - Assembler delimiter rule is presented by 
concatenating two dummy arguments and other characters beginning with 
a delimiter. In detail, one such concatenation string is a delimiter 
(i.e.,-»|), a dummy argument (i.e., FROM), the concatenation operator 
(i.e., @) , a second dummy argument (i.e., LVL) , finally followed by 
other characters beginning with a delimiter (i.e., ,X) . 

The general case of real argument for dummy argument substitution per- 
formed by MACRO is the application of the "other characters beginning 
with a delimiter" rule presented above. In other words, argument sub- 
stitution may be thought of as concatenation when the dummy argument 
is bounded by delimiters, rather than a concatenation operator. 

Note that one ambiguous case can arise in use of the concatenation opera- 
tor when the other character string to be concatenated with an argument 
value is the same as a dummy argument name. The following example 
illustrates this problem. 


W I' C‘"’0?LUN 



This macro was written with the intention of satisfying the following 
flow diagram. 
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Note that according to box 6 of the preceding flow chart, under these 
conditions it was desired to output: 


HeV10 


for line 7 of the above expansion rather than what was actually gener- 
ated. This discrepancy occurs because the characters EV on the appro- 
priate line of the body of the definition are not recognized as "other 
characters". EV is also a dummy argument which is bounded by an Ass- 
embler delimiter (i.e.,-»)on the left) and the concatenation operator 
(i.e., @ on the right). This will cause the concatenation of the value 
of dummy argument EV (i.e., null) and the value of the dummy argument 
LUN (i.e.. Iff), thus producing the output shown on line 7 of the ex- 
pansion. The only solution to this problem is to choose the names of 
dummy arguments to be different from any character strings to be used 
for concatenating. 

Following is a comprehensive example of the use of the concatenation 
operation in defining user macros: the definition of two macros, 

ERRMSG and MESSAGE. The purpose of ERRMSG is to cause a subroutine to 
be called (named ER.PRO) which will print an error message. 

It has as arguments the error number (from 0 to 77 g ) and an optional 
return address. The label of the error message to be output is created 
by concatenating 'ERM.' with the error number. (ERM.0, ERM.l, etc.) If 
no return address is specified, control is transferred to a label named 
ER.NOR by default. The second macro, MESSAGE, is used to create an 
IOPS ASCII line buffer with the error message to be printed, presumably 
via the ERRMSG macro. It also has two arguments: the error number, 
and the message text. The output of the macro is a properly set up 
header word pair labeled 'ERM.xx' where 'xx' is the specified error 
number, and a .ASCII statement which contains the text specified, pre- 
ceded by 'ERR#xx--', where ' xx ' once again is the error number. The 
reader should examine the example noting the use of the conditional 
assembly parameters to accomplish macro-time error detection. 
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/ 

.title 

CONCATENATION EXAMPLE for 

MACRO MANUAL 

/ 

/ m a r p o 
/ 

' frrmsg ' 

DEFINITION , FRROR message 

OUPUT 

MACRO. 

/ 

/ 

t 

CALLING 

SEQUENCE : 




/ 

/ 

t 

pRRMSO 

EFRNO C , RETURN! 




/ 

/ 

/here: 





/ 

fRRNQ * 

AN OCTAL number FROM 0 TO 

77 

REPRESENTING 

/ 


THE ERROR COOE. 




/ 

return < 

(OPTIONAL) THE LOCATION 

TO 

WHICH 

CONTROL 


/ SHOULD t)E RETURNED FOLLOWING OUTPUT OF 

/ THE ERROR MESSAGE. IF NOT SPECIFIED, 

/ CONTROL WILL HE GIVEN TO LOCATION 'ER.NOR'. 

/ 

/ OUTPUT: 

/ 

/ OUTPUT OF ERRMSG CONSISTS OF A JMS TO THE ERROR PROCESSOR 

/ 'ER.PRO', FOLLOWED BY A .USA ERM.xx WHERE XX = ERRNO. 

/ PRH.XX IS ASSUMtO TO HE A STANDARD IOPS ASCII LINE PUFFER 

/ VHICH CONTAINS THE DESIRED MESSAGE. IT MAY RE OEFINEO USING 

/ THE 'MESSAGE' MACRO (SEE BELOW). 

/ 

/ error detection: 

/ 

/ THE ERROR NUMBER ('ERRNO') IS CHECKED TO BE BETWEEN 

/ ’ And 77. OTHERWISE AN ASSEMBLER ERROR LINE IS 

/ OUTPUT RATHER Than THE CALL TO 'ER.PRO'. Thf ILLEGAL 

/ aSSEMBER LINE WItL CAUSE AN 'N' ERROR (AMONG OTHERS) TO BE 

/ GENERATED 3Y THE ASSEMBER, THUS INDICATING A 'NUMBER' 

/ oRROR. 

/ 

.DcFIN 
. IFNEG 

. I Fp n z 

Z2RTmc*RTN+0 

.IFZER 

ZZRTNCsFr.NOR 
. E n D C 
T M S 
. D S A 
JMP 
. E N 0 C 
.ENOC 
. IFNEG 

s 

.ENDC 
.IFPOZ 
9 

.ENDC 
. EnDM 

'MESSAGE' DEFINITION, BUILD AN ERROR MESSAGE LINE BUFFER. 

calling sfouence: 

MESSAGE E n RNO,<TEXT> 

where: 

ERRNO = THE ERROR NUMBER, FROM pi TO 77 (OCTAL) 

<TEXT> = THE MESSAGE TEXT (ENCLOSED IN ANGLE 

BRACKETS, AS SHOWN) TO BE ASSOCIATED wITh ThIS 
' ERRNO ' . 


/MACRO 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 


EPRMSG , ERRNO , RTN 

ERRNO-HM /VALIDATE ERROR COPE number 

ERRNO /TO BE 0 <* ERRNO <® 77 

/SETUP RETURN AODR. IF SPECIFIED 

ZZRTNC 

/IF NO RETURN, SET TO STD. AODR. 

ER.PRO /CALL THE ERROR PROCESSOR 

ERM.fE'RRNO /POINT TO RIGHT MESS AGE 

ZZRTNC /EITHER RETURN TO STD. EXIT, OR WHERE 1 


ERRNO 


/PUT OUT ERPOR IF NECESSARY 


♦♦ERROR CODE IS < 0 OR > 77 ♦♦ 


EPRno- 1 f P) 

♦♦ERROR CODE IS < 


0 OR > 77** 


SAID 
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/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 


pPM 


A' . 


r.UTPtjT: 

A STANDARD IOPS ASCII LIME SUFFER is CREATED WITH THE NAME 
■E^M.Xx' WHFRE XX = 'fcRRNO' C SEE ABOVE). THE ACTUAL MESSAGE 
WILL have The FOR hat 'EWR#XX-- TEXT WHERE XX AND TEXT ARE AS 

ABOVE. OF COURSE* The LIME BUFFER HEADER pair will be PRQVIOED, 

eptor detection: 

• P R » N 0 ' WILL BE CHECKED to be BETWEFN v3 AMU 77. 

IF THE CHECK SHOWS AN F R R 0 R , AN ASSEMBLER ERROR 
I IME WILL BE GENERATED RATHfR THE ThE MESSAGE CODE. THE ERROR 
I I S, E will CAUSE AT LEAST AN 'N' FLAG* INDICATING A 'NUMBER' 
ERROR, 


.DEE IN 
. IFNEG 
.TFPOZ 
*F R R fjO 
0 

.ASCII 

MESSAGE. EHRNO, TEXT, ?A 
ERRNO-100 
E R R M 0 

A-ERM.#ERRNO/2*1000*2 


'ERR*0ERRNO--TEXT'<15> 


. E M D C 
. E N n C 
.IFNEG 

EPRhq 


9 

♦♦ERROR CODF IS < 0 OR > 

7 7** 

.ENDC 
. IFPOZ 

ERR NO-100 


9 

.EUOC 
. ENDM 
.EJECT 

♦♦ERROR CODF IS < 0 OR > 

77** 



gRRMSG 

4 /OUTPUT 

error message #4 

*G 

.IFNEG 

4-100 



*G 

.IFPOZ 

4 



*G 

ZZRTNCb+0 




* G 

. IFZER 

zzrtnc 



* G 

ZZRTNCaFR.NDR 




*G 

. E N 0 C 




*G 

JMS 

E R , P R O 



*G 

. OS A 

ERM.4 



*G 

J M P 

Z7RTNC 



*G 

.ENDC 




*G 

.emqc 




*G 

.IFNEG 

4 



*G 

9 

♦♦ERROR COUF 

IS 

< 0 OR > 77** 

* G 

.ENDC 




* G 

.IFPOZ 

4-100 



♦ G 

9 

♦♦ERROR COUF 

IS 

< 0 OR > 77** 

* a 

.ENDC 





ERRMSG 

45, RECOV 


/GIVE ERROR #45, 

*G 

.IFNEG 

45-100 



* G 

.IFPOZ 

45 



* G 

ZZRTnc*ReCCV+D 




* G 

.IFZER 

Z’RTNC 



*G 

ZZRTNC*FR.NO« 




* G 

.ENDC 




* G 

JMS 

ER.RRO 



*G 

. DSA 

EDM. 45 



* G 

JhP 

ZZRTnC 



*G 

.FNOC 




* G 

.ENDC 





TAKE STANDARD EXIT 


ANU RETURN TO LOC 'RECDV WHEN DONE 
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*G 




*r. 




* G 




* G 

, , 0006 ■ . 



*G 

.EMOC 



*o 

.FNOC 



*G 

.IFNEG 

4 


*G 

9 

♦•ERROR CODE IS < 0 (JR 

> 7 7 ♦ * 

* G 

,E\iOC 



*6 

.IFPOZ 

4-1^0 


*G 

9 

♦♦ERROR CODE IS < 0 OR 

> 77** 

* G 

.E'.nc 




MESSAGE 

4 5 r « A M S I G U 0 1 . S USE OF A 

COMPILER KEYRQRD> 

*r. 

. IFNEG 

45-100 


*G 

.IFPOZ 

45 


*G 

FRM, 45 ..0009- 

ERM. 45/2*1 000+2 


*G 

0 



* G 

.ASCII 

'FRR#45--AMFIGU0IIS USE 

OF A COMPILER KEYWORO'<15> 


*r, 

*r> 


*t 

*G 

*G 

* G 

* G 

* G 
*G 

*G 

* G 

*G 

*r. 


*G 

. IFNEG 

45 




*G 

9 

♦♦ERROR 

CODE 

IS 

< 0 OR > 77** 

* G 

.Ef'OC 





* G 

.IFPOZ 

45-100 




* G 

9 

♦♦ERROR 

CODE 

IS 

< 0 OR > 77** 

*G 

. E NOC 






F P K M S G 

-34 # kEC0V 


/SHOW THAT A NEGATIVE ERROR NO. IT 

* K 

.IFNEG 

-34-100 




* G 

.IFPOZ 

-34 




* G 

ZZRTn,C*RfCOV + 0 





*G 

. IFZER 

ZZRTNC 




♦G 

ZZRTMC«e~,‘iOR 





* G 

. E N 0 C 





*G 

JMS 

er.pro 




* G 

. D$a 

E R M , - 3 4 




* G 

JMP 

Z Z R T N C 




*G 

. SL^nc 





* G 

.ENDC 





* G 

. IFNEG 

-34 




* G 


♦♦ERROR 

CO OF 

IS 

< 3 OR > 77** 

*G 

.EOPC 





* G 

.IFPOZ 

- 3 4 - 1 0 0 




*G 

9 

♦♦ERROR 

CODE 

IS 

< 0 OR > 77** 

* G 

. E N 0 C 






gRSMSG 

456 

/SHOw 

that AN ERROR no. > 77(B) IS ILLEGAL 

* G 

.IFNEG 

456-130 




* G 

.IFPOZ 

456 




* G 

zZRTvr**r, 





* G 

.ifzer 

ZZRTNC 




* G 

ZZRTmcsE-.NOR 






illegal 
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*G 

. ENQC 


*G 

jMS 

ER.PRO 

* G 

Ids a 

ERN.456 

«G 

JMP 

zzrtnc 

*G 

.F-WDC 


*G 

. E N D C 


* G 

.IFNEG 

456 

*G 

9 

* * E R R D R CODF IS < 0 OR > 77** 

*G 

.E^DC 


*G 

. IFPOZ 

465-100 

* f? 

9 

••ERROR CODE IS < 0 DR > 77** 

* G 

.ENDC 



.EJECT 



MESSAGE 

4,<ILLEGAL DR UNRECOGNIZABLE SYNTAX IN STMNT> 

* G 

.IFNEG 

4-100 

*G 

.IFPOZ 

4 

*G FRM.4 

. .0006- 

ERM. 4/2* 1000+2 

*G 

0 


* G 

.ASCII 

1 FRRi»4--ILLF0AL OR UNRECOGNIZABLE SYNTAX IN STUNT 


♦ G 

* R 


*G 

*G 

* G 
♦P 
+ G 

* G 
*G 
*G 

* G 
*G 
*P 

* G 
*P 

* G 


*l, 

*G 

* G 

* G 
*G 
*G 

* G 

* G 
•G 
*G 

* G 
*G 

* G 


*G 

*G 

*G 

*G 

* G 
+ G 

* G 
*G 

* G 

* G 
’G 
*G 
*G 
* 1 . 


. . 000Q« . 

. ENiDC 
. E N 0 C 


.IFNEG 

9 

45 

♦♦ERROR 

CODE 

IS 

< 0 OR 

> 77** 

.cnPC 

.IFPOZ 

9 

45-100 
♦ ♦ERROR 

CODF 

IS 

< 0 OR 

> 77** 


.EMDC 

MESSAGE -1,<THIS Shruun GIVE a MACRO-DETECTED EWROR> 

.IFNEG -1-100 
.IEPOZ -1 

E R M , - 1 . ,3fll2-ER M .- 1/2*1000 + 2 

0 

.ASCII tFRRtt-1— THJS SHOULD GIVE A M ACRO-DfcTECTEO ERR0R'<15> 

..0012b, 

.ENOC 

.ENOC 

.IFnEG -1 

9 **ERROR CODF IS < 0 OR > 77** 

.ENpc 

.IFPOZ -1-100 

9 **ERRDR CUDF IS < 0 OR > 77** 

.ENDC 

.EJECT 
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4.4 NESTING OF MACROS 


Macros may be nested; that is, macros may be defined within other mac- 
ros. For ease of discussion, levels may be assigned to these nested 
macros. The outermost macros (those defined directly) will be called 
first-level macros. Macros defined within first-level macros will be 
called second-level macros; macros defined within second-level macros 
will be called third-level macros, etc. Each nested macro requires an 
. ENDM pseudo-op to denote its termination. 

Example ; 


Level 1 


. DEFIN— ) LEVEL1 , A, B 

-|lacH a 

— ItAdHb Level 2 


H .DEFIN-|LEVEL2, c,d 

HiszHc 

HdAcH D Level 3 



-*) .DEFIN-HLEVEL3, e, f 
— |and-»|e 

-*| XOR -•) F 

. ENDM 



LEVEL 3 . ENDM 

HdacH z 

-J . ENDM ^ 


LEVEL 2 .ENDM 

Hdac Hy 

-*) . ENDM ^ 

, LEVEL 1 .ENDM 


At the beginning of processing, first-level macros are defined and may 
be called in the normal manner. Second and higher level macros are 
not yet defined. When a first-level macro is called, all its second- 
level macros are defined. Thereafter, the level of definition is irre- 
levant and macros may be called in the normal manner. If the second- 
level macros contain third-level macros, the third-level macros are 
not defined until the second-level macros containing them have been 
called . 


Using the example above, the following would occur: 
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40 
*G 
>!< (3 
4 G 
#G 


00003 

00004 


440012 ft 40) 
040013 ft 4G 
4 G 
40 
4 '3 
*G 

040017 ft *G 












If LEVEL 3 is called before LEVEL2 it would be an error and the line 
would be flagged as undefined. 

When a macro of level n contains another macro of the level n + 1, call- 
ing the level n macro results in the generation of the body of the macro 
into the user's program in the normal manner until the .DEFIN statement 
of the level n + 1 macro is encountered; the level n + 1 macro is then 
defined and does not appear in the user's program. When the definition 
of the level n + 1 is completed (.ENDM encountered) , the Assembler con- 
tinues to generate the level n body into the user's program until, or 
unless, the entire level n macro has been generated. 

4.5 REDEFINITION OF MACROS 

If a macro name, which has been previously defined, appears within 
another definition, the macro is redefined and the original definition 
is eliminated. For example, 


When the macro INDXSV is called for the first time, the subroutine call- 
ing sequence is generated and followed immediately by the subroutine 
itself. After the subroutine is generated, a .DEFIN that contains the 
name INDEXSV is encountered. This new macro is defined and takes the 
place of the original macro INDEXSV. All subsequent calls to INDXSV 
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cause only the calling sequence to be generated. The original defini- 
tion of INDXSV will not be removed until after the expansion is complete. 


00000 

R .1.00002 R 

t'o 

I* N I> X S V 
JMS 

SAVE 

00001 

R 600010 R 


v.JMP 

SAVX 

00002 

R 000000 A 

*G SAVE 

0 


00003 

R 200010 !■• 

-'■!< b 

LAC 

; 

00004 

R 0400.10 R 

tc 

DAC 

TMF ir 

00005 

R 200011 A 

>!<{') 

; . }>; Q 


000 06 

R 040011 R 

:«■) 

D AC 

r Mr L 

00007 

R 4)20002. R 


JiiP$ 

S A 0 E 


000010 R 

*G SAVX7 
/ G 
*G 

JMS 

uNDX 

• :< i : i v J 


&G ENDM 


4.6 MACRO CALLS WITHIN MACRO DEFINITIONS 


The body of a macro definition may contain calls for other macros which 
have not yet been defined. However, the embedded calls must be de- 
fined before a call is issued to the macro which contains the embedded 
call. Embedded calls are allowed only to three levels. 

Example : 



%' 0 v . .1. N 
LAC 

f .• C '• >• 


r A a r. y 

C ? v ;i 


PAC 

E 


* r' i.i ft 



.BE Fl'N 

MAC 2 :*■ 


X0R 

AND 

A 

B 


, ENDM 
MACl 

TAG :l 

#8 

LAC 

TAG:!. 

t' G 

TAD 

TAG2 

*s 

MA 02 

( 400 > 

*0 

XOR 

< 400 > 


AND 

, y s 


DAC 

T A G 3 


.'J .... U CA.i. 


/DEFINITION OF EMBEDDED £ ALl 




The call 


causes generation of 
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4.7 RECURSIVE CALLS 

Although it is legal, avoid making a macro definition* containing an 
embedded call to itself because the expansion will cause more than 
three levels to occur. 


Example : 


.DEFIN MAC s’ A >■ B ? C 

LAC A 

TAD B 

DAC C 

MAC A B > C 

« ENDM 


/RECURSIVE 


When a call for MAC is encountered, the Assembler searches memory 
for the definition and expands it. Since there is another call for 
MAC contained within the definition, the Assembler goes back once again 
to obtain the definition; this process would never cease if more than 
three levels were allowed. A conditional assembly statement could be 
used, however, to limit the number of levels as in the following 
example . 


Example; 

A=0 
B 3 

.DEFIN 

DAC 

A “AT 1 

. IFNZR 
MAC 
. ENDC 
. ENDM 


MAC ? C r 1.1 

C 

D 

B-A 

S A V E t T E M P / R E C U R S I U E C A L I. . 


Names and arguments of nested macros and arguments of embedded calls 
may be substituted and used with perfect generality. 
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<• DEI FIN 

MAC 1 y A y B y C 

LAC 

A 

ADD 

B 

DAC 

C 

* DEFIN 

D y E 

AND 

DAP. 

A 

!"■ 


* ENDM 
, ENDM 



, DEF I i 

'! MAC2 y M y N y 


i:sz 

M 


JHP 

R 


MAC! 

N y 0 y P y Q 

* 

* ENDM 




MAC 2 

COUNT y TAG:! 

¥- G 

ISZ 

coun r 

MG 

JMP 

* 4 0005 

MG 

MAC .!. 

TAG ! v T AG2y 

*G 

LAC 

TAG:! 

# G 

ADD 

f AG2 

MG 

DAC 

TAG 3 

MG 

. DEF IN 

MAC 3 y E 

MG 

AND 

TAG" 

MG 

DAC 

E 

MG 

ENDM 


#G * . 0005“ 

«■ 
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CHAPTER 5 

OPERATING PROCEDURES 


5 . 1 INTRODUCTION 

Detailed descriptions of the assembler calling procedure, command 
string format, general operating procedures, and printouts are given 
in this chapter. 

5.2 CALLING PROCEDURE 

5.2.1 XVM/DOS 

\ 

In the XVM/DOS systems, the MACRO Assembler is called by typing MACRO J 
after the Monitor's $ request. When the Assembler has been loaded, it 
identifies itself by typing: 

MACRO XVM Vnxnnn or BMACRO XVM Vnxnnn 
> > 

on the teleprinter. The > character indicates that the Assembler is 
waiting for the user to type in a command string. 

There are two differences between MACRO XVM (the Page Mode Assembler) 
and BMACRO XVM (the Bank Mode Assembler) . MACRO XVM starts each as- 
sembly assuming page mode relocation ( .DBREL implied) and BMACRO XVM 
assumes bank mode relocation (.EBREL implied). When program sizes 
exceed 4096, MACRO outputs the warning message "PROG 4K" in the assembly 
listing but BMACRO does not. This message will appear even if the pro- 
gram is assembled under influence of .EBREL. This warning message has 
no other effect; the program will be assembled and output will be pro- 
duced anyway. 

5.2.2 RSX/XVM 

In the RSX systems, MACRO is invoked by typing in the Assembler's name 
and also the command string on the same line following the prompting 


5-1 



Operating Procedures 


message "TDV For example: 

TDV>MAC BLXR «- FILE J 
MACRO XVM Vnxnnn 

The Assembler identifies itself, as just shown, only if the R option is 
designated in the command. The RSX version of the Assembler is equival- 
ent to BMACRO in that it assumes .EBREL to begin with and does not 
print " PROG >4K" . 

5.3 GENERAL COMMAND CHARACTERS 


The following characters are frequently used in the entry and control 
of MACRO programs . 


Character Printout 


RUBOUT (Echoes \) 
CTRL U (Echoes I?) 
CTRL P (EchoestP) a 


delete single character 
delete current line 

If the input source is physically segmented 
so that all but the last segment end with .EOT 
or nothing, the Assembler will print out the 
message 


EOT 

when the end of a segment is reached. In XVM/ 
RSX, the Assembler does not type any such mes- 
sage. 

b. If the source is segmented in such a way that 
operator intervention is required to load 
another segment, MACRO will print 


+ P 

(MAC-tP in XVM/ RSX) and wait for the user to key 
in CTRL P (CTRL pJ in XVM/RSX) . Except in 
XVM/RSX, the user response will be printed also 
and the line will appear as 


t PtP 


In XVM/RSX if no other tape is to be loaded, 
terminate assembly by typing CTRL QV . 

c. At the start of PASS 2 or PASS 3 if input is 
on paper tape or if the source is segmented on 
DECtape or Magtape with segments being read via 
the same .DAT slot, the Assembler will request a 
CTRL P response as above. 
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d. If the Assembler is not waiting for more input, 
or is not waiting to start the next pass, 
typing CTRL P causes the Assembler to restart 
at PASS 1. This is true for all systems except 
XVM/RSX. 

CTRL D (Echoes + D) If the user specifies the Teleprinter as the 

input parameter device, he can delimit the param- 
eter code by typing CTRL D (+D) (followed by 
with the XVM/RSX Monitor) . MACRO responds with 
EOT. MACRO immediately begins assembling the 
program from the device assigned to .DAT-11 
(LUN 15 with XVM/RSX) . 


5 . 4 COMMAND STRING 


The command string format consists of a string of options, followed by 
a left arrow, followed by the program name(s), followed by a terminator. 

options-<-f ilnml , f ilnm2 , . . . 

The following sections describe the rules for forming proper command 
strings and show typical assembly examples. The character terminating 
the command line has significance. Terminating the line with a carriage 
return will cause the Assembler to re-initialize itself to PASS 1 at 
completion of the assembly; the Assembler is thus ready to accept an- 
other command string. Terminating the command with an ALT MODE will 
cause a return to the monitor at the end of assembly. In the XVM/RSX 
systems these line terminators have a different meaning. Termination 
with carriage return causes TDV to be called; termination with ALT MODE 
does not. In either case, the Assembler exits after executing the com- 
mand line. If a command string error occurs, the entire command must 
be retyped. 

5.4.1 Program File Name 

To the right of the back arrow in the command string, one or more pro- 
gram file names may be required, depending upon the options used and 
the type of I/O devices. Where several names are needed, they are 
separated by commas. 

Program names are required for files which are to be input from or out- 
put to directoried devices. The two proper forms for a file name are 

f ilnami_iext 
or 

f ilnam 
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where 

filnam = 1 to 6 character name 

ext = 1 to 3 character extension 

These may be formed from any of the legal printing characters shown in 
Appendix A and may appear in any order. 

If the file name extension is omitted, the Assembler assumes SRC in 
default. Following are examples of single name command strings. 


Examples : 


User Command String 


jABCDEFi—ilJ^y 1 
ABi_i01 1 
-Aj 

■hAECDEFGV > 
vABCDEFGujHV, 
«-ABCi_jt_iVIAV 


Assembler Interpretation 
Name Extension 


ABCDEF 100 

AB 011 

A SRC 

ABCDEF G 

ABCDEF H 

ABC SRC 


The last three examples illustrate how the Assembler interprets im- 
properly formed file names. If the file name is longer than six char- 
acters but is not followed by a space, the seventh, eighth and nineth 
characters are used as the extension. If it is followed by a space, 
characters beyond the sixth and before the space are ignored. If two 
spaces follow the file name, the extension is assumed to be SRC. In 
general, if too many characters are given the excess characters are 
ignored . 


The extension name of the main program is output (unless the 0 option 
is present) as a special code in the relocatable binary file. This 
enables programmers to easily identify different versions of the same 
program by merely assigning unique extension names. If the P- option 
is utilized, the Linking Loader and UPDATE print out the source file 
names, including extension. 

Regardless of the source file extension, such as TEST 001, the binary 
file extension will be either BIN, meaning relocatable binary, or ABS, 
meaning absolute binary. 

5.4.2 Options 


Assembler options direct the course of the assembly. They describe 
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the types of input and output desired. Option characters are listed to 
the left of the back arrow. They may be listed in any order and are 
typically not separated one from the other (although commas and spaces, 
which are ignored, may be used as separators) . Option characters which 
appear more than once and invalid characters are ignored. 

Examples : 


Command 


Meaning 


b«-fileJ 

BLS+NAME J 


■ PROGi_j01X.J 


Assemble FILE SRC and produce a 
binary object file. 

Assemble NAME SRC and produce a 
binary object file and an assembly 
listing followed by a symbol table 
listing. 

Assemble PROG 01X producing no out- 
put except a list of assembly er- 
rors, if any, on the listing device 
assigned to .DAT -12 (LUN 16 in 
XVM/RSX) . 


The following table shows the action and the default of the options. 


Option 


Action 


Default Action 


A Print symbols at end of PASS 2 

in alphanumeric sequence on 
listing device. 

B Generate a binary file to DAT -13 

with extension BIN or ABS, as re- 
quired. (LUN 17 in RSX) . 

C Program areas that fall between 

unsatisfied conditionals are 
not printed. It is not nec- 
essary to type the L option if 
this option is used. 

E This option enables the user 

to have any errors occurring 
during assembly printed on the 
console printer in addition 
to the device assigned to .DAT 
-12 (LUN 16 in RSX). The L or 
N switch should be used with 
the E option. This option is 
particularly useful to users 
who assign non-printing de- 
vices to .DAT -12. 

F Read macro definition file from 

.DAT -14 (LUN 18 in RSX) during 
PASS 1 . Terminate input with 
.EOT or CTRL D if Teletype 1 
(CTRL D J if RSX) . 

G Print only the source line of 

a macro expansion. It is not 
necessary to type the L option. 


teletype is a registered trademark of the 


Symbols are not printed 
in alphanumeric sequence. 

A binary file is not gen- 
erated . 

All source lines are 
printed . 


Assembly errors are not 
printed on the console 
printer . 


No macro definition file 
is processed. 


Generate printouts for 
macro expansions and ex- 
pandable pseudo-ops (e.g., 
•REPT) . 

Teletype Corporation. 
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Option 


Action 


Default Action 


H The H-option is used in con- 
junction with the A, V, or S 
options. User symbols are 
normally printed horizontally 
at the end of PASS 2, four 
symbols to a line. If the H- 
option is used the symbols 
will be printed one to a line. 

I Ignore .EJECT'S. The .EJECT 

pseudo-op is treated as a 
comment . 

L Generate a listing file on the 
requested output device, DAT 
-12. (LUN 16 in RSX) . If the 
output device is directoried, 
then the listing file extension 
will be LST. 

N Number each source line (dec- 

imal) . If this option is used, 
it is not necessary to type the 
L option. 

0 Causes the assembler to omit 
the source extension and the 
linking loader code 33 from the 
binary file. This option must 
be used when assembling pro- 
grams in the DOS or RSX systems 
to be run in ADSS or B/F. 

P Before assembly begins, read 

program parameters from DAT -10 
(LUN 20 in RSX) . Terminate 
input with .EOT or CTRL D (if 
Teletype) . The parameter file 
is read only once; for this 
reason, only direct assignments 
may be used. 

R Identify the Assembler version 

number, print END PASS 1 and 
END PASS 2, and print the er- 
ror count on the teleprinter 
(RSX only) . 

S Same as selecting both A and V. 


T The T option causes a "Table 

of Contents table to be gener- 
ated during PASS 1. The table 
will contain the page number 
and text of all assembled 
.TITLE statements in the pro- 
gram. 

V Print symbols at end of PASS 2 
in value sequence on listing 
device . 


Print symbols four to a 
line. 


Skip to head of form when 
.EJECT is encountered. 

A listing file is not gen- 
erated (see options N,C). 


Source lines are not num- 
bered. 


Loader code 33 is included 
in the binary output. 


No parameters, begin assem- 
bly immediately after com- 
mand string termination. 


These items are not printed 
in order to speed up batch 
processing . 


Symbols are not printed. 
(If neither option V, S 
nor A is requested, sym- 
bols are not printed.) 

A table of contents is not 
generated at the head of 
the assembly listing. 


Symbols are not printed 
in value sequence. 
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Option 


Action 


Default Action 


X 


z 


At completion of PASS 2, PASS 3 
is loaded to perform the cross- 
referencing operation. At com- 
pletion of PASS 3 the Assembler 
will call in PASS 1 and 2, to 
continue assembling programs. 

If the command string was termin- 
ated by an ALT MODE, control will 
return to the Monitor at the end 
of assembly. Without the N op- 
tion the user would obtain a 
cross reference which would be 
effectively useless since the 
source lines of the listing are 
not numbered. The N option is 
automatically entered if you 
enter L and X. 

The Z option is related to the 
macro definition file option F. 

Z has no effect if F is not also 
specified. F and Z are used in 
combination when the main program 
is segmented into two parts. 

The first part containing in- 
structions other than simply 
macro definitions, must be read 
both during PASS 1 and PASS 2. 
This is the function of the Z 
option. 


A cross-reference is not 
provided and PASS 3 is 
not called in. 


The F option, if specified, 
causes the Macro definition 
file to be read only during 
PASS 1 . 


5.4.3 Multiple Filename Commands 


In the general case a command may require up to three file names, de- 
pending upon the options specified, to produce a single binary output 
file. As will be illustrated later on, the Assembler in XVM/RSX sys- 
tems allows multiple assemblies to be specified in a single command, 
which may require more than three file names. For the other software 
systems, the limit is three. Names may be needed to specify parameter 
files, macro definition files and program files. The use of these 
names and the manner in which they are interpreted by the Assembler 
are described in the following paragraphs. 


NOTE 

In the following descriptions any file which is 
processed by both PASS 1 and PASS 2 of the As- 
sembler is also processed during PASS 3 if the 
cross-reference option (x) is specified. 
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NAME 1: PARAMETER FILE 

If the P option is used and the device assigned to .DAT slot -10 (LUN 
20 in XVM/RSX) has a directory, the first name is interpreted as being 
the parameter file name. The name of the file must be explicitly stated 
if it is on a directoried device. If the device assigned to the para- 
meter file is non-directoried, the first name typed would follow the 
rules for name 2. The parameter file is passed over only once during 
PASS 1. 


If the P option is not used, only two names are accepted by the com- 
mand string processor. The first name then would follow the rules 
for name 2. 

NAME 2s MACRO DEFINITION FILE 

If the F option is used, the second name (or the first if the P option 
is not used) is interpreted as being the macro definition file or part 
one of a two part program (assuming the device assigned to .DAT -14 
(LUN 18 in RSX) has a directory) . If the device is non-directoried, 
the second file name (or first if the P-option is not used or doesn't 
require one) would follow the rules for name 3. The macro definition 
is normally passed over only once, during PASS 1. However, unlike the 
main program file, macro definitions on .DAT slot -14 are recorded in 
core during PASS 1. Hence, PASS 2 is unnecessary. If the Z option is 
used with the F option this file will be passed over twice, allowing 
source files in two parts on two different devices. The Z-switch has 
no effect if F is not specified. 

If the F option is not used, the first name (second if P option is used) 
is interpreted as the file name of the program to be assembled. 

The macro definition file may also be used as an additional parameter 
file. A second parameter file is useful where a program is conditionally 
assembled to produce different versions according to many assembly par- 
ameters . 


NOTE 

The RSX MACRO does not contain definitions of sys- 
tem directives and I/O calls. MACRO definitions 
or RSX are in a file called RMC.v SRC, where v 
changes with each release. 
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NAME 3: PROGRAM FILE NAME (Name of the Program to be Assembled) 

This file is processed from .DAT slot -11 (LUN 15 in RSX) and always 
by both PASS 1 and PASS 2. If the P and F options are not used and 
multiple names are typed, only the first name will be processed. If 
a binary output file is requested, it will be directed to .DAT slot 
-13 (LUN 17 in RSX). If either of the two devices has a directory, 
a file name must be specified. The binary file will assume the name 
of the program file and an extension of either BIN or ABS . 

MULTIPLE NAME INTERPRETATION 

Before processing, the Assembler uses the .FSTAT function (SEEK in RSX) 
to determine whether or not the named files are on the input devices. 

If not, the message "NAME ERROR" is typed. In all but the RSX and 
BOSS XVM systems the Assembler then expects the command string to be 
retyped. In RSX, the Assembler exits and calls TDV so that the com- 
mand string can be given to TDV. In BOSS XVM the Assembler exits to 
the monitor. Assuming that enough names have been typed to satisfy 
the command string options, MACRO interprets the file names as follows: 

a. Current name = NAME 1. 

b. Was the P option used? If not, go to step f. 

c. Is the device assigned to .DAT slot -10 (LUN 20 in RSX) 
directoried? If not, go to step f. 

d. Use the current name (NAME 1) to .SEEK the parameter file 
via .DAT slot -10 (LUN 20 in RSX) . 

e. Current name = NAME 2. 

f. Was the F option used? If not, go to step j. 

g. Is the device assigned to .DAT slot -14 (LUN 18 in RSX) 
directoried? If not, go to step j . 

h. Use the current name (NAME 1 or NAME 2) to .SEEK the MACRO 
definition file via .DAT slot -14 (LUN 18 in RSX) . 

i. Current name = NAME 3 (or NAME 2 in P option not used) . 

j. Use the current name (NAME 1 or NAME 2 or NAME 3) to .SEEK the 
program file via .DAT slot -11 (LUN 15 in RSX) . 

RULES FOR MULTIPLE NAMES IN THE COMMAND STRING 

1. Initial blanks positioned after the back arrow are ignored. 

2. Files are processed sequentially. The first name after the 
left arrow is the first file read, the second file is next 
and so on. 
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3. Once a string of legal name characters is started, a space 
has the following effect on a name. 

a. The first space delimits the proper name and indicates to 
the command string processor that the extension name is 
next. The proper name is defined as the first six char- 
acters of a file name, excluding the extension. 

b. Two consecutive blanks delimit the name. An extension of 
'SRC' is implied if no extension was typed. 

4. A comma or line terminator delimits the name. (Same as 3b 
above. ) 

5. Any name given after the third name is ignored, except in XVM/ 
RSX . The XVM/RSX assembler allows multiple assemblies to be 
specified in a single command. Where the options require one, 
two or three file names, the command may contain multiples of 
one, two or three. Each such group of one, two or three names 
represents a single assembly. 


RESTRICTIONS CAUSED BY MULTIPLE FILE INPUT (not relevant to XVM/RSX) 


The .FSTAT system macro is used by the MACRO Assembler to determine 
whether or not the input device has a directory and whether or not the 
argument names are on the assigned devices. For this reason, only 
those I/O handlers which honor or which ignore the .FSTAT function may 
be used with MACRO. The "A" handlers for directoried devices (e.g., 
DTA, DKA) honor .FSTAT. The paper tape punch and reader handlers ig- 
nore .FSTAT, but the effect is as if they accept it. Device handlers 
which treat .FSTAT as illegal may not be used. 

5.4.4 Examples of Commands for Segmented Programs 

Below are typical assembly situations which illustrate the usage of 
some of the assembly options and show the resulting teleprinter output. 
The output for XVM/RSX differs slightly from what is shown. That is 
explained in section 5.3. 

1 . Segmented Program on Paper Tape 

A source main program is segmented onto three paper tapes to 
make loading in the reader easier. Tapes one and two termin- 
ate with an .EOT statement and tape three terminates with 
.END. All three segments are read from the primary input, 

.DAT -11 (LUN 15 in RSX) . The command to MACRO to produce 
a binary program is: 

>B *■ ANYNAM J 

Note that tape 1 must be ready in the reader before the com- 
mand string is entered. Were it not, the reader would return 
an end of tape condition anyway and erroneous results would 
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be obtained. The resulting teleprinter output is shown below. 
The comments to the right are not part of the output; these 
are included here as explanatory remarks. User responses are 
underlined . 

>B +■ AHYNAMV 1 


EOT 

/End of tape 1. 




IP tP 

/Ready tape 2. 

Type 

CTRL 

P. 

EOT 

/End of tape 2. 




IP 1 P 

/Ready tape 3. 

Type 

CTRL 

P. 

END OF PASS 1 
IP 1 P 

/Ready tape 1 . 

Type 

CTRL 

P. 

EOT 

/End of tape 1 . 




tPt P 

/Ready tape 2. 

Type 

CTRL 

P. 

EOT 

/End of tape 2. 




tPtp 

/Ready tape 3 . 

Type 

CTRL 

P. 


SIZE=01203 NO ERROR LINES 

2. Segmented Program on DECtape 

A source main program cannot fit onto a single DECtape. It is 
split in two on two different DECtapes and given the same file 
name: MAIN SRC. The tape one file ends with .EOT; the tape 

two file ends with .END. The file names must be identical if 
both segments are to be read via the primary input, .DAT -11 
(LUN 15 in RSX) . Example 3 illustrates an alternate method. 
However, example 2 must be used if one also is to include a 
MACRO definition file, as in example 4. The following com- 
mand to MACRO produces a binary program and the subsequent 
teleprinter output: 

> B <- MAIN 


EOT 

/End of file 1. 

Mount 

second 

tPtP 

/DECtape on same 
/CTRL P. 

unit . 

Type 

END OF PASS 

1 /End of file 2. 

Mount 

first 

1 P +_P 

/DECtape on same 
/CTRL P. 

unit . 

Type 

EOT 

/End of file 1. 

Mount 

second 

1 PlP 
SIZE=/J2I703 

/DECtape on same 
/CTRL P. 

NO ERROR LINES 

unit . 

Type 


3. Segmented Program on Disk 

This example is a variation of number 2. A two part main 
program resides on disk. It doesn't matter whether the two 
files are on the same or separate disk units. Part one ter- 
minates with .EOT; part 2, with .END. PARTI SRC will be 
read via the secondary input, .DAT -14 (LUN 18 in RSX) ; and 
PART 2 SRC will be read via the primary input, .DAT -11 
(LUN 15 in RSX) . The resultant binary file, produced by 
the following command to MACRO, will assume the name of the 
second (primary) file: PART 2 BIN or PART 2 ABS, as the case 
may be: 

> BFZ <- PARTI , PART 2 J 
EOT /End of 

END OF PASS 1 /End of 

EOT /End of 

SIZE=020/3 NO ERROR LINES 


PARTI SRC. 
PART 2 SRC. 
PARTI SRC. 
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Several points can be made about the differences between 
examples 2 and 3. First, note that CRTL P type in is not 
required unless input is from a device like paper tape. 

Next, note that example 2 is impractical on disk because it 
requires physically interchanging disks. Example 3 is not 
restricted to usage with disk, but can be used with other 
media as well. 

4. Use of a Macro Definition File 

MACDEF SRC, which terminates with .EOT, contains only macro 
definitions. It is read from the secondary input, .DAT -14 
(LUN 18 in RSX) . The user has a main program, USEMAC 002, 
which terminates with .END and which calls some of these 
macros but does not itself define them. This is just an ex- 
ample. It is perfectly legal for the main program to redefine 
macros which also appear in the macro definition file. 

USEMAC 002 is read from the primary input, .DAT -11 (LUN 15 
in RSX) . Below is the appropriate command string to produce 

a binary program. Note that the F option without the Z op- 

tion (see example 3) instructs the Assembler to read the 
first file (the Macro definition file) only during PASS 1. 

> BF 4- MACDEF, USEMAC 002J 

EOT /End of MACDEF SRC. 

END OF PASS 1 /End of USEMAC 002. 

SIZE=011J2!4 NO ERROR LINES 

Note that EOT is not printed during PASS 2 because MACDEF 
SRC is read only during PASS 1. The preceding example as- 
sumes that the files are on directoried devices. 


5. Parameter File on Paper Tape 

A main program, MAIN SRC, which terminates with .END is con- 
ditionalized to produce different binary code based on the 
values or existence of certain assembly parameters. It is 
read via the primary input, .DAT -11 (LUN 15 in RSX) , which, 
for this example, is assigned to DECtape. A paper tape con- 
taining parameter definitions (direct assignments) terminates 
with .EOT and is read via the auxiliary input, .DAT -10 
(LUN 20 in RSX) . The following command to MACRO produces a 
binary program: 

> BP MAIN> 

EOT /End of parameter tape. 

END OF PASS 1 /End of MAIN SRC. 

SIZE=/06/2 NO ERROR LINES 

Note, although input is partly from paper tape, a CTRL P res- 
ponse is unnecessary because the parameter tape is read only 
during PASS 1. 


6. Multiple File Assemblies in XVM/RSX 

Using the Assembler in XVM/RSX, several assemblies, using 
the same set of options for each, may be specified in a sin- 
gle command. Unless the R option is used, no printout on the 
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teleprinter will occur to signal the various stages of assem- 
bly. Eelow are listed two typical commands in RSX. 

> MAC BL + PI, P2,_j003, P3, paJ 

This requests four assemblies. A separate binary and listing 
are produced for PI SRC, P2 003, P3 SRC and P4 SRC. 

> MAC PB «- PARI, FILl, PAR2,FIL2> 

This requests two assemblies. A separate binary is produced 
for FILl SRC and FIL2 SRC. The parameter file PARI SRC is 
applied to the assembly of FILl SRC and PAR 2 SRC to that of 
FIL2 SRC. 


5.5 ASSEMBLY LISTINGS 


If the user requests a listing via the command string, the Assembler 
will produce an output listing on the requested output device. The 
top of the first page of the listing will contain the name of the pro- 
gram as given in the command string. The body of the listing will be 
formatted as follows: 


Line 

No. 

Error 

Flags 

Loca- 

tion 

Address 

Mode 

Object 

Code 

Address 

Type 

Line 

Type 

Source 

State- 

ment 

xxxx 

XXX 


R 


R 

*G 

X 

X 






A 

*L 








E 

*R 









*E 




where: 


Line Number = 


Flags = 

Location = 

Address Mode = 

A = absolute 
R = relocatable 

Line Type = 

Object Code = 
Address Type = 


Each source line and comment line is 
numbered (decimal) ; generated lines 
are not included. Lines are not num- 
bered unless the X or N option is 
specified. 

Errors encountered by the assembler 

Relative or absolute location assign- 
ed to the object code. 

Indicates the type of user address. 


*G = Generated *L = Literal 
*R = Repeated *E = External 

The contents of the location (in 
octal ) 

Indicates the classification of the 
object code. 
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A = absolute 
R = relocatable 
E = external 

The object codes assigned for literals and external symbols are listed 
following the program. 

5.6 SYMBOL TABLE OUTPUT 

At the end of PASS 2, the symbol table may be output to the listing 
.DAT -12 (LUN 16 in RSX) device. If the A option is used, the table 
will be printed in alphanumeric sequence; if the V option is used, 
the symbol table will be printed in numeric value sequence; if the S 
option is used, the symbol table will be output in both alphanumeric 
and numeric sequence. The format is as follows: 

Symbol Value Type 

SYMBL1 XXXXX E 

SYMBL2 XXXXX R 

DIRECT XXXXXX A 

The Xs represent the octal value assigned to the symbol. This is the 
location where the symbol is defined, except for external symbols. 

For these, the value is the location of the transfer vector, whose 
contents are set at program load time with the actual value of the 
symbol. Note that for SYMBLl and SYMBL2 there are five Xs but that 
there are six Xs for the symbol DIRECT. Symbols having six octal num- 
bers to represent their values are the result of direct assignments. 

The symbol table shows the type of symbol: 

A = absolute 
R = relocatable 
E = external 

Locations assigned to variables immediately follow the last object 
code producing statement in the assembled program. Locations assigned 
for literals not under . LTORG influence and transfer vectors are listed 
immediately following the variables; if no variables are used in 
the program, literals and transfer vectors immediately follow the pro- 
gram output. 
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page 


Sample SRC 


SAMPLE PROGRAM 


A3 
4 A 
AS 
AS 


.TITLE SAMPLE PROGRAM 

SAMPLE SUBROUTINE, not CLAIMED TO WORK OR TO have any practical 
VALUE, used to illustrate the output ON An ASSEMBLY LISTING, 
THESE LINES are COMMENTS. 

THIS LISTING WAS OBTAINED USING BMaCRO” 1 5 IN DOS-15 WITH THE 
FOLLOWING COMMAND options to macro: LSX 


10 




*0*005 

A 

0UT*5 



/.DAT SLOT 5. 

11 







. IODEV 

OUT 


12 







.GLOBl 

PRINT, SAVE, 

RESTOR 

13 






/ 




14 







.IFUNO 

WIDTH 

/CONDITIONAL ASSEMBLY. 

IS 







.DEC 



16 






WIDTH* 

72 


/DECIMAL NUMBER. 

17 







.OCT 



18 







, ENDC 



IB 




000040 

A 

BuFSIZ*WlDTH+4/5*2+2 

/DIRECT ASSIGNMENT. 

20 






/ 




21 


OB*** 

P 

*000*0 

A 

PRINT 

0 


/SUBROUTINE ENTRY POINT. 

22 


ooooi 

0 

*4*1 16 

R 


DAC 

ACSAVft 

/VARIABLE. 

23 


00**0 

P 

9**123 

R 


LAC 

( S A VBUF ) 

/LITERAL. 

24 


*0003 

P 

130122 

E 


JMS* 

SAVE 

/EXTERNAL CALL, 

25 


00004 

0 

93*116 

R 


LAC* 

ACSAV 

/BUFFER AOORESS. 

26 


00005 

P 

7413*0 

A 


SNA 



27 

U 

00006 

0 

6**1 1 7 

R 


JMP 

NOBUFF 

/UNDEFINED SYMBOL (MISSPELLED) 

26 

x 

00007 

0 

*400*3 

A 


DAC 

WRITE+3 

/UNOEFJNEO SYMBOL BECAUSE OF 

26 


00*10 

P 

733777 

A 


AAC 

-1 

/ 2 FORWARD REFERENCES. 

30 


00*1 1 

P 

*6* 1 ?4 

R 


DAC* 

(10) 

/AUTOINDEX REGISTER. 

31 


0001 0 

P 

777740 

A 


LAW 

-BUFSIZ 


32 


*0*13 

0 

*4*1 1 5 

R 


DAC 

COUNT 


33 


00*1 4 

0 

736*00 

A 


CLX 



34 


*001 5 

P 

35»0 1 * 

A 

LOOP 

LAC* 

1* 


35 


*00 10 

P 

*5**55 

R 


DAC 

BUF.x 

/INDEX REGISTER REFERENCE. 

36 


00017 

P 

44*115 

R 


ISZ 

COUNT 


37 


0003* 

P 

60*015 

R 


JMP 

LOOP 


36 


00031 

P 

600034 

R 


JMP 

CHANGE 


36 


00*30 

P 

30*125 

R 

NOBUF 

LAC 

(ERRMSG) 


40 

u 

00033 

P 

*40123 

R 


DAC 

WRIT + 3 

/UNDEFINED (MISSPELLED). 

41 


00*34 

P 

7400*0 

A 

CHANGE 

NOP 



42 







. INIT 

OUT, 1 ,0 

/SYSTEM MACRO CALL. 


00*36 

00*96 

*05137 

0**30 

00*31 

»003* 


0010*5 

*00001 

*00000 

oooooB 

000126 

04*034 


*G 
• G 
*G 
*G 


CAL*t*1O00 0UTS777 
1 

0 + 0 
0 

LAC 
DAC 

.EJECT 


(JMP AROUND) 
CHANGE 


/PAGE EJECT. 
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PAGE 

2 

SAMPLE 

SRC 

SAMPLE 

PROGRAM 




47 




000033 

R 


WRITE* AROUND 


/FORWARD REFERENCE. 


48 


00*33 

0 




AROUND 

.WRITE 

OUT, 2, XX, 0 

/SYSTEM MACRO CALL. 




00033 

Q 

009005 

A 

«G 



CAL*2* 1 000 0UT8777 





00034 

0 

00001 1 

A 

*G 



11 






00038 

P 

740040 

A 

*G 



XX 










*G 



.OEC 






00038 

P 

000000 

A 

* G 



-0 




49 







/ 






50 









.WAIT 

OUT 

/SYSTEM MACRO CALL. 




00037 

P 

000005 

A 

*G 



CAL 0UT&777 





00040 

P 

000012 

A 

*G 



12 




31 


00041 

P 

900123 

R 




LAC 

t SAVBUF ) 



32 


00049 

P 

120121 

E 




JMS* 

RESTOR 

/EXTERNAL CALL, 


53 


00043 

P 

9001 16 

R 




LAC 

ACSAV 



54 


00044 

P 

*20000 

R 




JMP* 

PRINT 



55 







/ 






36 







/ 

THE 

NEXT LINE 

CONTAINS THREE 

.statements. 


57 







/ 






58 


00045 

P 

003002 

A 


ERRMSG 

003002 f 

0) .ASCII /ERR0R/<15> 




0004* 

0 

000000 

A 










00047 

P 

42*452 

A 










00050 

P 

947644 

A 










00051 

P 

084000 

A 










00059 

P 

000000 

A 








59 


00059 

P 






,LOC 

. - 1 

/CHANGE LOCATION COUNTER. 

80 


00059 

P 


A 


SAVBUF 

.BLOCK 

3 

/MQ, xr and lr. 


81 


00055 

P 


A 


BUF 

.BLOCK 

BUFSIZ 



82 


001)5 

P 

000000 

A 


COUNT 

0 




83 







/ 






84 







/ 

FOLLOWING The 

.END STATEMENT 

ARE THREE LOCATIONS 

(NOT SHOWN) 

85 







/ 

FOR 

ONE VARIABLE C ACS A V 3 AND 

TWO UNDEFINED SYMBOLS (NOBUFF 

86 







/ 

ANO 

WRITE, THE 

LATTER BECAUSE 

OF A DOUBLE FORWARD 

REFERENCE) 

67 







/ 

FOLLOWING That 

(SHOWN) ARE TWO EXTERNAL TRANSFER 

VECTORS 

68 







/ 

ANO 

FOUR LITERALS. 



69 







/ 






70 




000000 

A 




.END 






00121 

P 

000121 

E 

«E 









00129 

P 

000122 

E 

*E 









00123 

P 

000052 

R 

*L 









00124 

P 

00001 0 

A 

*L 









00125 

P 

000045 

R 

*L 









00128 

P 

*00033 

R 

*L 









Sl7E»00130 



3 

ERROR LINES 
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S A N, B | r tfc'T 


A C S A V 

'1011 « 

R 

4 'Mi' 0 

CHANGt 

00*24 

a 

C'Tl.i T 

NOBUF 

00*29 

9 

4 * B ! • F F 

PESTOP 

00121 

F 

$ A V B U F 

WRIT 

*012* 

R 

u i r e 

PRINT 

*000* 

R 

(Ti‘T 

change 

*pi*24 

R 

AROi'N 1 ' 

EPRmSG 

*0*45 

R 

S ■*. V '1 !J F 

COUNT 

00115 

R 

4*5 A V 

REST PR 

00121 

f 

F >' V F 


HAiPLt PROGPAH 


0 0035 

K 

HiiF 

*0*55 

R 

00 115 

K 

ERSMSr. 

* 0 0 4 5 

R 

0*117 

h 

Out 

0 * P. 0 0 5 

A 

0*052 
:i I,’ *033 

K 

h 

SAVE 

*0122 

E 

*0 1005 

A 

LOOP 

00*15 

R 

0*033 

K 

WRITE 

0*01433 

R 

*• * 35 ? 

H 

huf 

die *55 

R 

0 3110 
0*122 

K 

t 

NpBjFP 

00117 

R 


S A " P I E C»0*S REFERENCE 


ACSAV 

0 0 115 

?2 

AROUND 

*0*3* 

i 3 

RUF 

*0*55 

* 5 

BUFSIZ 

(**0*4* 

1 o* 

CuANGt 

00024 

OH 

COUNT 

* 011 * 

*? 

ERRhSG 

*0245 

OS 

LOOP 

***1 * 

*4* 

N09UF 

* 2 * 2 ? 

?R* 

nobuff 

0*117 

?7 

OUT 

000024 

1 0 4 

PRINT 

***14* 

1 ? 

RESTOP 

02121 

1 2 

SA VBL'F 

0**5? 

93 

SAVE 

* 012 ? 

1 2 

WIDTH 

0*0 J 1 * 

1 4 

WRIT 

**1 24 

00 

WRITE 

0 ** 03 * 

r> a 


?5 4 3 

4 7 4 B * 

M * 

■M M 

A 1 * 44 

3 t- 4 2 * 

5e* 

3 7 


U 4 2 4 e 4 n 

?1 * *54 

52 

•S 1 «•/•* 

9 4 

' 4* 13 

17* 


bufsiz *p¥i*4¥i a 

LOOP ¥10015 R 
PRINT 170000 R 
WIDTH 000110 A 


NQtsUF 00022 R 
HUF5IZ 0*0*42 A 
inIUTH 000110 A 
WRIT 00120 R 


5.7 RUNNING INSTRUCTIONS 


Once the Assembler has identified itself, it is ready to perform an 
assembly. Proceed as follows: 

a. Place the source program to be assembled on the appropriate 
input device. 

b. Type the command string. 

5.7.1 Paper Tape Input Only 


The following steps are required when the source program is encountered 
in the paper tape reader: 

a. At the end of a source tape segment which is not terminated 
with a .END statement of at the beginning of PASS 2 or PASS 3, 
the Assembler types 

+ P 

b. Place the proper source tape in the reader. 
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c. In XVM/DOS type CTRL P to continue. For RSX, type CTRL P ) . 
5.7.2 Cross-Reference Output 

At the end of PASS 2, PASS 3 will be performed by the Assembler for the 
cross-referencing operation if the X option is requested. At completion, 
the assembler will be restarted (except in RSX systems) to permit addi- 
tional assemblies if the command string is terminated by a CARRIAGE 
RETURN (J) entry. 

When a cross reference output is requested, the symbols are listed in 
alphabetic sequence. The first address after the symbol is the location 
where the symbol is defined or its 6-digit value if it is a direct 
assignment. All subsequent locations represent the line number (deci- 
mal) where the symbol was referenced. The line number with the 
asterisk is that in which the symbol is defined. Leading zeroes are 
suppressed for the cross-reference symbol table. Nine line numbers 
are printed on one line and subsequent line numbers are continued on 
the next line. 

Example : 


PAGE 

1 

PRGA 

CROSS REFERENCE 

A 

1 

XXXXX 

XXXXX* XXXXX 



xxxxx 

XXXXX 

B 

5000 

XXXXX* 


SYMBOL 

100 

xxxxx* 



Cross referencing can be a useful tool even without the aid of a line 
printer. It is possible to put the source assembly listing with line 
numbers onto a directoried device, such as DECtape , and the cross 
reference table (by a separate assembly) on a teleprinter. Then, 
desired lines in the "LST" file can be accessed by using the EDITOR. 

LIMITATIONS 


A. Before cross reference output can begin, PAS S3 of the Assem- 
bler must first have read the entire source file(s) and 
stored the reference line numbers in core memory. Should 
available core be too limited, the Assembler will output the 
following message to the listing: 

CORE EXHAUSTED AT LINE DDDD 

where D is a decimal digit. Then the Assembler outputs all 
the references found up to that point. 
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B. For programs with more than 9999 lines of source code, 

line numbers begin again at 0 000 on line 10000 . In the 

cross-reference listing, 10000 is represented as 1000 , 
11000 as ; 000 , and so on. These special characters are 
simply those which follow the numerals in the ASCII char- 
acter set (Appendix A) . Below is a list of characters 
and their meanings. 

: 10 

? 11 

< 12 

= 13 

> 14 

? 15 

c. To conserve core space, PASS3 of the Assembler does not 
maintain a permanent symbol table. Consequently, if user 
defined symbols are identical to permanent symbols, ref- 
erences to the permanent symbols will be included in the 
cross reference. For example: 

LAC A 
TAD LAC 


LAC 5 

Three references to LAC will be listed. 

D. Conditionals ( . IFxxx through . ENDC ) are treated during 
PASS 3 as if they are always satisfied. Consequently, 
although a conditional might not be satisfied during 
PASSl and PASS2, references within to defined user sym- 
bols will appear in the cross-reference output. 

Note that undefined symbols which are referenced in . IFDEF 
and . IFUND statements remain undefined; hence, these do 
not appear in the cross reference. 


5.8 PROGRAM RELOCATION 


The normal output from the MACRO XVM Assembler is a relocatable object 
program, which may be loaded into any part of memory regardless of 
which locations are assigned at assembly time. To accomplish this, 
the address portion of some instructions must have a relocation con- 
stant added to it. This relocation constant is added at load time by 
the Linking Loader, CHAIM or TKB ; it is equal to the difference be- 
tween the memory location that an instruction is actually loaded into 
and the location that was assigned to it at assembly time. The As- 
sembler determines which storage words are relocatable (marking them 
with an R in the listing) , which are absolute (making these non-relocat- 
able words with an A) and which are external (marking these with an E) . 
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The rules that the Assembler follows to determine whether a storage 
word is absolute or relocatable are as follows: 


a. If the address is a number (not a symbol), the address is 
absolute. 

b. If the address is a symbol which is defined by a direct assign- 
ment (i.e., =) and the righthand side of the assignment is a 
number, all references to the symbol will be absolute. 

c. If a user symbol is defined within a block of coding that is 
absolute, the value of that symbol is absolute. 

d. Variables, undefined symbols, external transfer vectors, and 
literals get the same relocation as was in effect when .END 
was encountered in PASS 1. 

e. If the location counter (.LOC pseudo-op) references a symbol 
which is not defined in terms of a relocatable address, the 
symbol is absolute. 

f. All others are relocatable. 


The following table depicts the manner in which the Assembler handles 
expressions which contain both absolute and relocatable elements. 

(A=absolute, R=relocatab.le) 

A+A=A A-R=R R+R=R and flagged as possible error 

A-A=A R+A=R R-R=A 

A+R=R R-A=R 

If multiplication or division is performed on a relocatable symbol, it 
will be flagged as a possible relocation error. 

If a relocatable program exceeds 4K, and the assembler is a page mode 
version, the following warning message will be typed at the end of 
PASS 2: 

PROG > 4K 

5.9 SYSTEM ERROR CONDITIONS AND RECOVERY PROCEDURES 
5.9.1 XVM/DOS and BOSS XVM 

See the XVM/DOS User's Manual, Appendix D or the XVM/DOS Keyboard 
Command Guide, Appendix C for descriptions of IOPS error messages. 
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5.9.2 XVM/RSX 


Printout Recovery Procedure 

MAC-I/O ERROR LUN xx YYYYYY is produced on LUN 3: xx represents 

the Logical Unit Number (decimal) 
and YYYYYY the octal Event Variable 
value indicating the cause of the 
error. See the XVM/RSX System Man- 
ual for the meaning of the error 
Event Variables. Control is auto- 
matically returned to TDV. 


5.9.3 Restart Control Entries (DOS only) 


CTRL P Restart Assembler, if running 

CTRL C Return to Monitor 

5.10 ERROR DETECTION BY THE ASSEMBLER 

MACRO XVM examines each source statement for possible errors. The 
statement which contains the error will be flagged by one or several 
letters in the left-hand margin of the line, or, if the lines are num- 
bered, between the line number and the location. The following table 
shows the error flags and their meanings. 


Flag Meaning 

A Error in direct symbol table assignment - assignment 

ignored 

B 1. Memory bank error (program segment too large) 

2. Page error - the location of an instruction and 
the address it references are on different mem- 
ory pages (error in page mode only) 

C A . ENDC appears before an unsatisfied . IFxxx. 

D Statement contains a reference to a multiply-defined 

symbol - the first value is used. 

E 1. Symbol not found in user's symbol table during 

PASS 2 

2. Operator combined with its operand may produce 
erroneous results 

F Forward reference - symbol value is not resolved by 

PASS 2 

I Line ignored: 

1. Relocatable pseudo-op in .ABS program 

2. Redundant pseudo-op 

3. .ABS pseudo-op in relocatable program 

4. .ABS pseudo-op appears after a line has been 
assembled 
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5. A second .LOCAL pseudo-op appears before a 
matching . NDLOC pseudo-op 

6. An .NDLOC appears without an associated .LOCAL 
pseudo-op 

7. Too many . LTORG pseudo-ops (more than 8) 

8. . IODEV pseudo-op in .ABS or .FULL program 

9. Illegal statement within .CBS and .CBE 

L Literal error: 

1. Phase error - literal encountered in PASS 2 does 

not equal any literal found in PASS 1 

2. Nested literal (a literal within a literal) 

M Multiple symbol definition - first value defined is 

used 

N Error in number usage (digit 8 or 9 used under .OCT 

influence) 

P Phase error: 

1. PASS 1 symbol value not equal to PASS 2 symbol 
value (PASS 2 value ignored) 

2. A tag defined in a local area (.LOCAL pseudo-op 
is also defined in a non-local area 

Q Questionable line: 

1. Line contains two or more sequential operators 
(e.g. , LAC A+*B) 

2. Bad line delimiter - address field not terminated 
with a semicolon, carriage return or a comment 

3. Bad argument in .REPT pseudo-op 

4. Unrecognizable symbol with .ABS(P) pseudo-op 

R Possible relocation error 

S Symbol error - illegal character used in tag field 

U Undefined symbol 

W Line overflow during macro expansion 

X Illegal use of macro name or index register 

1. Unmatched .IFxxx and . ENDC 

2. Unmatched .DEFIN and .ENDM 

3. Unmatched .CBS and .CBE 

In addition to flagged lines, there are certain conditions which will 
cause assembly to be terminated prematurely. 


Message 


Meaning 


SYNTAX ERR Bad command string, control returns to TDV 

(RSX only) 

? Bad command string, retype (not RSX) 


NAME ERROR 


TABLE OVERFLOW 

CALL OVERFLOW 

CORE EXHAUSTED 
AT LINE nnn 


File named in command string not found. In 
DOS, the Assembler will restart and accept 
another command string. RSX MACRO will re- 
turn to TDV. EOSS will return to the Monitor. 

Too many symbols and/or macros 

Too many embedded macro calls 

PASS 3 error - too many symbol references 
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CHARACTER SET 


Printing 

Character 

7-bit 

ASCII 

6-bit 

Trimmed 

ASCII 

Printing 

Character 

7-bit 

ASCII 

6-bit 

Trimmed 

ASCII 

@ 

100 

00 

Form Feed 

014 


A 

101 

01 

Carriage Return 

015 


B 

102 

02 

ALT MODE (ESC) 

175 


C 

103 

03 

Rubout 

177 


D 

104 

04 

(Space) 

040 

40 

E 

105 

05 

1 

041 

41 

F 

106 

06 

" 

042 

42 

G 

107 

07 

# 

043 

43 

H 

110 

10 

$ 

044 

44 

I 

111 

11 

% 

045 

45 

J 

112 

12 

& 

046 

46 

K 

113 

13 

1 

047 

47 

L 

114 

14 

( 

050 

50 

M 

115 

15 

) 

051 

51 

N 

116 

16 

★ 

052 

52 

0 

117 

17 

+ 

053 

53 

P 

120 

20 

I 

054 

54 

Q 

121 

21 

- 

055 

55 

R 

122 

22 


056 

56 

S 

123 

23 

/ 

057 

57 

T 

124 

24 

0 

060 

60 

U 

125 

25 

1 

061 

61 

V 

126 

26 

2 

062 

62 

w 

127 

27 

3 

063 

63 

X 

130 

30 

4 

064 

64 

Y 

131 

31 

5 

065 

65 

z 

132 

32 

6 

066 

66 

[* 

133 

33 

7 

067 

67 

\ 

134 

34 

8 

070 

70 

]* 

135 

35 

9 

071 

71 

t* 

136 

36 

■ ★ 

072 

72 

*<-* 

137 

37 

7 

073 

73 

Null 

000 


< 

074 

74 

Horizontal Tab 

Oil 


= 

075 

75 

Line Feed 

012 


> 

076 

76 

Vertical Tab 

013 


■p 

077 

77 


*Illegal as source, except in a comment or text. Any characters not 
in this table are illegal to MACRO XVM and are flagged and ignored. 
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APPENDIX B 


PERMANENT SYMBOL TABLE 


Operate 

GLK 


750010 

DBK 

703304 

OPR 

740000 

LAW 


760000 

DRR 

703344 

NOP 

740000 


EAE 


IOF 

700002 

CMA 

740001 

EAE 


640000 

ION 

700042 

CML 

740002 

LRS 


640500 

CAF 

703302 

OAS 

740004 

LESS 


660500 

RES 

707742 

RAL 

740010 

LLS 


640600 


Memory Reference 

RAR 

740020 

LLSS 


660600 

CAL 

000000 

I AC 

740030 

ALS 


640700 

DAC 

O4OQ00 

HLT 

740040 

ALSS 


660700 

JMS 

100000 

XX 

740040 

NORM 


640444 

DZM 

] 40000 

SMA 

740100 

NORMS 


660444 

LAC 

200000 

SZA 

740200 

MUL 


653122 

XOR 

240000 

SNL 

740400 

MULS 


657122 

ADD 

300000 

SML 

740400 

DIV 


640323 

TAP 

340000 

SI<P 

741000 

DIVS 


644323 

XCT 

400000 

SPA 

741100 

IDIV 


6 5 3 3 2 3 

ISZ 

44000 n 

SNA 

741200 

ID1V3 


657323 

AND 

5 roc- d 

SZL 

741400 

FRDIV 


650323 

SAP 

540000 

SPL 

741400 

FRDIV: 

3 

654323 

jf'p 

6 0 0 0 0 0 

RTL 

742010 

CLAC 


6410(0 

A 

u t oma tic Priority 

RTR 

742020 

LACQ 


64] 002 


Interrupt 




SWHA 

742030 

LACS 


641001 

RPL, 

705512 

CLL 

744000 

CLQ 


650000 

SPI 

705501 

STL 

744002 

ARS 


644000 

ISA 

705504 

CCL 

744002 

GSM 


664000 

Index Instructions 
Which Take an Immediate 

RCL 

744010 

osc 


640001 

Nine-bit Operand 

RCR 

744020 

OMQ 


640002 

AAC 

723000 

CLA 

750000 

CMQ 


640004 

AXR 

737000 

TCA 

740031 

LMQ 


652000 

AXS 

725000 

CLC 

750001 


IOT 



Mode Switch inn 

LAS 

750004 

IOT 


700000 

ERA 

707764 

LAT 

750004 

IORS 


700314 

DRA 

707762 
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P ermanent Symbol Table 


Index and Limit Register 
Instructions Which do 


not use Operands 


CLLR 

736000 

PAL 

722000 

PAX 

721000 

PLA 

730000 

PLX 

731000 

PXA 

724000 

PXL 

726000 

CLX 

735000 

Index 

Reaister Value 

X 

10000 
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APPENDIX C 

MACRO CHARACTER INTERPRETATION 


Character 

Name Symbol 

Space *— i ' 


Horizontal tab 

Semicolon 
Carriage return 
Plus 

Minus 

Asterisk 

Slash 


Question mark 
Quotation mark 
Apostrophe 
Number Sign 
Dollar sign 
Line feed 
Form feed 
Vertical tab 
Commercial At 


H 

I 

) 

+ 

* 

/ 

& 

i 

\ 

( 

) 


7 

m 

i 

# 

$ 

non-printing 
non-printing > 
non-printing 

e 


Ampersand 
Exclamation point 
Back slash 
Opening parenthesis 
Closing parenthesis 
Equals 

Opening angle 
bracket 

Closing angle 
bracket 

Comma 


Function 

Field delimiter. Designated by «_i 
in this manual. 

Field delimiter. Designated by -»| 
in this manual. 

Statement terminator 

Statement terminator 

Addition operator (two's comple- 
ment) 

Subtraction operator (addition of 
two ' s complement) 

Multiplication operator or indirect 
indicator 

Division operator or comment 
initiator 

Logical AND operator 
Inclusive OR operator 
Exclusive OR operator 
Initiate literal 
Terminate literal 
Direct Assignment 
Argument delimiter 

Argument delimiter 

An argument delimiter in macro 
definitions or an exclusive OR 
operator 

Created symbol designator in macros 

Text string indicator 

Text string indicator 

Variable indicator 

Real argument continuation 

not applicable 

Concatenation operator in macro 
definitions 
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Macro Character Interpretation 


Character Function 

Name Symbo 1 

Null Blank Character Ignored by the Assembler 

Delete Blank Character Ignored by the Assembler 

Illegal Characters 

Only those characters listed in the preceding table are legal in MACRO 
XVM source programs, all other characters will be ignored and flagged 
as errors. The following characters, although illegal as source, may 
be used within comment lines and in text preceded by .ASCII or .SIXBT 
pseudo-ops . 


Character Name Symbol 

Left bracket [ 

Right bracket 3 

Up arrow + 

Left arrow 

Colon : 


C-2 



Pseudo-op 

(Section) 

.ABS (3.2.1) 
. ABSP (3.2.1 

.ASCII (3.3. 


. BLOCK (3.11 

. CBC (3.5.4) 
. CBD (3.5.1) 

. CBE (3.5.5) 
. CBDR (3.5.2 


★ 

All pseudo 


APPENDIX D 

SUMMARY OF MACRO XVM PSEUDO-OPS 


) 


1 ) 


Format 


-j.ABS -) NLD/ 1 
-*| . ABSP-*) NLDj 


Function 

Object program is output 
in absolute, blocked, 
checksummed format for 
loading by the Absolute 
Binary Loader. Not 
supported in RSX. 


label*-*) .ASCII-*) /text/<octal> > ) 


Input text strings in 
7-bit ASCII code, with 
the first character 
serving as delimiter. 
Octal codes for nonprint- 
ing control characters 
are enclosed in angle 
brackets . 


) label*-) .BLOCK -*) exp ) 


Reserves a block of 
storage words equal to 
the expression. If a 
label is used, it refer- 
ences the first word in 
the block. 


-»| . CBC-*) displacement 


ilue^) 


Initialize a word of a 
common block to a con- 
stant . 


label*-*| . CBD -*)NAME, /size ^ Sets up a COMMON area 

having the name and size 
specified. The first 
element in the COMMON 
area is also given (base 
address) . 

— |.CBE^ End of common block ini- 

tialization section. 

r 

label*-*) . CBDR-*) displacement^ Enters the starting 

address of the last 
common block specified 
in a .CED plus the argu- 
ment into the location 
of the .CBDR. 


ops shown with a label generate binary output code. 
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Summary of MACRO XVM Pseudo-ops 


Pseudo-op 
( Section) 


Format 

Function 

.CBS (3.5.3) 


.CBS-*) name [, size] y 

Start common block ini- 
tialization section. 

. DBREL (3.2.3) 


H.dbrel^) 

Disable bank mode relo- 
cation . 

.DEC (3.10) 


H-decv 

Sets prevailing radix to 
decimal . 

. DEFIN (3.4) 


-»|. DEFIN-*) macroname, argsy 

Defines macros. 

. DSA (3.16) 

label* 

-»).DSAi_iexp^ 

Generates a transfer 
vector for the specified 
symbol . 

.EBREL (3.2.3) 


H-FFiREL/ 1 

Enable bank mode relo- 
cation . 

.EJECT (3.1.2) 


-*). EJECT ) 

Skip to head of form on 
listing device. 

.END (3.12) 


-*). END -») starty 

Must terminate every 
source program. START 
is the address of the 
first instruction to be 
executed . 

. ENDC (3.6) 


-~|. ENDC y 

Terminates conditional 
coding in .IF statements 

. ENDM (3.4) 


-*). ENDM 

Terminates the body of a 
macro definition. 

.EOT (3.13) 


-*). eotJ 

Must terminate physical 
program segments, except 
the last, which is 
terminated by .END. 

.ETC (3.4) 


-*). ETC-*) args , args^) 

Used in macro definition 
to continue the list of 
dummy arguments on 
succeeding lines. 

.FULL (3.2.2) 

. FULLP (3.2.2) 


-•). FULL ) 
-*). FULLP J 

Produces absolute, un- 
blocked, unchecksummed 
binary object programs. 
Used only for paper tape 
output . Not supported 
in RSX . 

-GLOBL (3.14) 


-*). GLOBL-*) sym, sym, syin, 

) Used to declare all 
internal and external 
symbols which reference 
other programs . 

★ 

All pseudo-ops 

shown 

with a label generate 

binary output code. 
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Summary of MACRO XVM Pseudo-ops 


Pseudo-op 

(Section) 

IFxxx (3.6) 


.IODEV (3.15) 


.LOC (3.9) 
.LOCAL (3.7) 

. LST (3.1.3) 

. LTORG (3.8) 

. NDLOC (3.7) 

. NOLST (3.1.3) 

.OCT (3.10) 
.RFPT (3.17) 


Format Function 

IFxxx -•) expj If a condition is satis- 

fied, the source coding 
following the .IF state- 
ment and terminating with 
an . FNDC statement is 
assembled . 


-•). IODEV -*| .DAT number s^) 

Specifies .DAT slots and 
associated I/O handlers 
required by this pro- 
gram. Not supported in 
RSX . 


LOC “•|exp^ 


-»{. LOCAL ^ 


-^.LST^} 


-^.LTORG^ 


NDLOCy 


NOLST.J 


-*). OCT J 


Sets the location counter 
to the value of the ex- 
pression . 

Allows deletion of cer- 
tain symbols from the 
user symbol table. 

Continue requested assem- 
bly listing output of 
source lines. Lines 
between .NOLST and .LST 
are not listed. 

Allows the user to 
specifically state where 
literals are to be stored. 

Terminates deletion of 
certain symbols from the 
user symbol table con- 
tained between .LOCAL 
and . NDLOC . 

Terminates requested 
assembly listing output 
of source lines of code 
contained between .NOLST 
and .LST. 

Sets the prevailing radix 
to octal. Assumed at 
start of every program. 


-*j. REPT -»| count , nj Repeats the object code 

of the next object code 
generating instruction 
Count times. Optionally, 
the generated word may be 
incremented by n each 
time it is repeated. 
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Summary of MACRO XVM Pseudo-op s 


Pseudo-op 

Section) Format Function 

SIXBT (3.3.2) label .SIXBT-^j/text/<octal>J 

Input text strings in 
6-bit trimmed ASCII, with 
first character as de- 
limiter. Numbers enclosed 
in angle brackets are 
truncated to one 6-bit 
octal character. 

SIZE (3.18) label -»j . SI ZE^) MACRO outputs the address 

of last location plus one 
occupied by the object 
program. 

TITLE (3.1.1) -*| . TITLE -»j any text string,) 

Causes the Assembler to 
accept up to 50 iq typed 
characters. During 
source program assembly 
operations, a .TITLE 
causes a form feed code 
to be output to place the 
text starting with .TITLE 
at the top of a page. 
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APPENDIX E 

SOURCE LISTING OF THE ABSOLUTE BINARY LOADER 


/♦** absolute binary 

/ .FULL 


700004 

CLOF = 700004 

7001 12 

RRB=700 1 12 

700 1 44 

RSB=7001 44 

700101 

RSF = 700101 

017720 

LDSTRT = 1 7720 

703302 

BINLDR CAF 

700004 

CLOF 

700012 

I OF + 10 

705504 

ISA 

740000 

LODMOD NOP 

707702 

707702 

017726 

LDNXBK=1 7726 

157775 

D2M LDCKSM 

117753 

JMS LDREAD 

057776 

DAC LDSTAD 

741100 

SPA 

617747 

JMP LDXFR 

1 17753 

JMS LDREAD 

057777 

DAC LDWDCT 

117753 

JMS LDREAD 

017736 

LDNXWD=1 7736 

1 1 7753 

JMS LDREAD 

077776 

DAC* LDSTAD 

457776 

ISZ LDSTAD 

457777 

ISZ LDWDCT 

61 7736 

JMP LDNXWD 

357775 

TAD LDCKSM 

740200 

SZA 

740040 

HLT 

61 7726 

JMP LDNXBK 

017747 

LD XFR = 1 7747 

057777 

DAC LDWDCT 

457777 

ISZ LDWDCT 

61 7763 

JMP LDWAIT 

740040 

HLT 

01 7753 

LDREAD=1 7753 


LOADER *** 


/CLEAR FLAGS 
/CLOCK OFF 
/INTERRUPT OFF 
/TURN OFF API 
/(EBA), (DBA), (NOP) 

/PDF - 9 COMPATIBILITY (EERO 

/CHECKSUMMING LOCATION 

/GET STARTING ADDRESS 
/BLOCK HEADING OR 
/START BLOCK 

/WORD COUNT ( 2 ' S COMPLEMENT ) 


/LOAD DATA INTO APPROPRIATE 
/MEMORY LOCATIONS 
/FINISHED LOADING 
/NO 

/LDCKSM SHOULD CONTAIN 0 
/CHECKSUM ERROR HALT 
/PRESS CONTINUE TO IGNORE 


/EXECUTE START ADDRESS 

/NO ADDRESS ON .END STATEMENT 

/MANUALLY START USER PROGRAM 
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Source Listing of the Absolute Binary Loader 


000000 

0 


700 1 AA 

RSB 


357775 

TAD LDCKSM 


057775 

DAC LDCKSM 


700101 

RSF 


617757 

JMP LDREAD +4 


700 1 1 2 

RRB 


637753 

JMP* LDREAD 



/THE LAST FRAME OF EVERY 

• ABS < P ) PROG IS GARBAGE. 

01 7763 

LDWA IT = 1 7763 


117753 

JMS LDREAD 

/PASS OVER LAST FRAME (PDP 

637776 

JMP* LDSTAD 

/COMPATIBILITY). 

006235 

ENDLDR = . 


003500 

000000 

HRMWD 003500; 0 

/HEADER 

000261 

000277 

261; 277 

/HRM START 

000320 

000000 

320; 0 


01 7775 

LDC KSM = 1 7 7 75 


01 7776 

LDSTAD=1 7776 


017777 

LDWDCT=1 7777 



/ .END BINLDR 

/*** END OF LOADER *** 
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INDEX 


AAC, AXR, AXS evaluation, 2-28 
Absolute 

address, 5-20 
format, 3-4, 3-5 
mode, 2-22 
symbol, 5-20 

Absolute Binary Loader (ABL) , 
3*4 

. ABSP pseudo-op, 3-4, 3-5, 3-6 
.ABS pseudo-op, 3-4, 3-5, 3-6 
Addition operator, 2-12 
Address assignments, 2-13 
Address field, 2-1, 2-2, 2-21 
Addressing , 
indexed, 2-15 
indirect, 2-14 

Angle bracket (<>) delimiters, 
3-9, 3-10, 4-6 
Argument delimiters, see 
Delimiters 
Arguments , 

dummy, 3-11, 4-1, 4-2, 4-3 
real, 4-4 

Arithmetic operators, 2-12 
ASCII character sets, 3-8, A-l 
.ASCII pseudo-op, 3-9, 4-3 
Assembler restart, 5-3 
Assembly listings, 5-13 
Assembly, optional, 3-15 
Asterisk (*) (multiplication 
operator) , 2-20 

Asterisk (*) usage, 2-14, 2-20 
At symbol (@) usage, 4-8 
Auto-index registers, 2-23 


Bank bits, 2-27 
Bank mode, 2-22 
Bank Mode Assembler, 5-1 
Base address, 3-12 
Basic statement, 2-1 
.BLOCK pseudo-op, 3-22 
Boolean operators, 2-12 


Calling procedure, 5-1 
Carriage-return, 2-1 
•CBC pseudo-op, 3-14 
. CBD pseudo-op, 3-11 
. CBE pseudo-op, 3-14 
. CBDR pseudo-op, 3-12 
•CBS pseudo-op, 3-13 
Characters , 

ASCII, A-l 
command, 5-2 


Characters, (cont.) 

MACRO, C-l 
nonprinting, 3-10 
Command characters, 5-2 
Command string format, 5-3 
Command string terminators, 5-3 
Comma ( , ) usage in argument 
string, 4-8 

Comments, 2-1, 2-3, 2-23, 4-2 
Common block 

definition, 3-11, 3-12 
initialization, 3-13, 3-14 
pseudo-operations, 3-11 
Concatenation, 4-8 
Conditional assembly pseudo- 
operators, 3-15 
Conditionals, 5-19 
Configuration, 1-2 
Created symbols, 4-7 
Cross-reference output, 5-18 
CTRL C, 5-21 
CTRL D, 5-3 
CTRL P, 5-2, 5-21 
CTRL U, 5-2 


. DBREL pseudo-op, 3-7 
Decimal values, 2-10 
.DEC pseudo-op, 3-21 
.DEFIN pseudo-op, 3-11, 4-2 
Delete current line, 5-2 
Delete single character, 5-2 
Delimiters , 
argument, 4-6 
field, 2-2, 2-20, 2-21 
statement, 2-2, 2-20, 2-21 
text, 3-9 

Devices, directoried, 3-5, 5-10 
Direct assignment statement, 2-3 
Division by zero, 2-12 
Division operator, 2-12 
Dollar sign ($) used as 
terminator, 4-5 
.DSA pseudo-op, 3-26 
Dummy arguments, 3-11, 4-1, 4-2, 
4-3 


EAE class instructions 
evaluation, 2-28 
•EBREL pseudo-op, 3-7 
.EJECT pseudo-op, 3-3 
Embedded macro calls, 4-19 
. ENDM pseudo-op, 3-11, 4-3 
End of program pseudo-operation, 
3-23 
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INDEX (Cont.) 


End of program segment pseudo- 
operation, 3-24 
.END pseudo-op, 3-23 
.EOT pseudo-op, 3-24 
Equal sign (=) usage, 2-8 
Error conditions, 5-20 
Error detection, 5-21 
.ETC pseudo-op, 3-11, 4-2 
Exclusive OR operator, 2-12 
Executable object program, 1-3 
Expressions, 2-12 
External symbols, 3-25 
External transfer vectors, 5-20 


Field delimiters, 2-2, 2-20, 
2-21 

Field-dependent symbols, 2-5 
Fields in statements, 2-1 
address, 2-21 
comments, 2-23 
label, 2-17 
operation, 2-20 
Filename commands, multiple, 
5-7 

Filenames, 5-3, 5-9 
Forward reference, 2-9, 3-17 
Fractional remainders, 2-12 
. FSTAT system macro, 5-10 
Full binary format, 3-6 
. FULLP pseudo-op, 3-5, 3-6 
.FULL pseudo-op, 3-5, 3-6 


Globals, evaluation of, 2-4 
Global symbol declaration 
pseudo-operation, 3-24 
Global symbol definitions, 

1-3 

. GLOBL pseudo-op, 3-24 


Handlers, 5-10 
Hardware, 1-2 


. IFxxx pseudo-ops, 3-15 
Inclusive OR operator, 2-12 
Indexed addressing, 2-15 
Index register, 2-25, 2-26, 4-3 
Indirect addressing, 2-14 
Instruction mnemonic symbols , 

2-5 

Integer values, 2-11 
Internal globals, 3-25 


Internal .GLOBL symbols, 2-9 

. IODEV pseudo-op, 3-26 

IOPS ASCII packed format, 3-9 


Label field, 2-1, 2-17 
Labels, 2-2, 2-4 
LAW evaluation, 2-28 
Library routines, 1-3 
Line numbers, 5-19 
Linking Loader, 1-1, 2-23 
Listing control pseudo-operations, 

3-3 

Listing output control, 3-4 
Literal origin pseudo-operation, 
3-20 

Literals, 2-16, 5-20 
.LOCAL pseudo-op, 3-17 
Local symbols pseudo-operators, 
3-17 

Location counter, 2-13, 2-14, 

5-20 

Location counter pseudo- 
operation, 3-21 
.LOC pseudo-op, 3-21 
Logical AND operator, 2-12 
. LST pseudo-op, 3-4 
. LTORG pseudo-op, 3-20 


Macro 

body, 4-3 
call, 4-19 
definition, 4-2 
definition file, 5-8, 5-12 
definition pseudo-operations, 
3-11 

instructions, 4-1 
nesting, 4-17 
redefinition, 4-18 
MACRO characters, C-l 
Memory, 3-17, 3-22, 5-19 
Memory references across page 
boundaries, 3-7 

Memory referencing instruction 
format, 2-6 
Mnemonics, 2-5 
Multiple file assemblies in 
XVM/RSX , 5-12 

Multiple filename commands, 5-7 
Multiplication operator, 2-12 


Name of program, 3-3 
. NDLOC pseudo-op, 3-17 
Nested conditional statements, 
3-16 
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INDEX (Cont.) 


Nested literals, 2-16 
Nesting of macros, 4-17 
NLD option, 3-5 
.NOLST pseudo-op, 3-4 
Non-printing characters, 3-10 
Numbers, 2-10 

evaluation of, 2-24 
Number sign (^) usage, 2-7, 4-3 


Object code, 1-3 
Object program output pseudo- 
operations, 3-4 
Octal values, 2-10 
.OCT pseudo-op, 3-21 
Operating procedures, 5-1 
Operation field, 2-1, 2^2, 
2-20 

Operators , 

arithmetic, 2-12 
Boolean, 2-12 
Options, 5-4 
Output, 1-1, 5-19 
code, 3-4 
listing, 5-13 


Page mode, 2-22 
Page Mode Assembler, 5-1 
Paper tape 
input, 3-6 
output, 3-5 
source program, 5-17 
Parameter file, 5-8 
Parentheses usage, 2-16 
Passes, 1-2, 2-9, 5-18 
Period (.) usage, 2-5, 3-1 
Permanent symbol table, 2-4, 3-1 
5-19, B-l 
Pointer, 1-3 
Processing, 1-2 
Program 
end, 3-23 

filename, 5-3, 5-9 
relocation, 5-19 
segment end, 3-24 
segment identification, 3-3 
size, 3-17 

Programs, relocatable, 1-3 
Pseudo-operations , 
common block, 3-11 
conditional assembly, 3-15 
designate a symbolic a 
address, 3-26 
end of program, 3-23 
end of program segment, 

3-24 


Pseudo-operations (Cont.), 

global symbol declaration, 3-24 
listing control, 3-3 
literal origin, 3-20 
location counter, 3-21 
macro definition, 3-11 
object program output, 3-4 
radix control, 3-21 
repeat object code, 3-26 
request I/O device handler, 3-26 
request program size, 3-28 
reserve blocks of storage, 3-22 
summary, 3-1, D-l 
text handling, 3-8 


Question mark (?) usage, 4-7 


Radix, 2-10 

Radix control pseudo-operation, 
3-21 

Real arguments, 4-4 
Reassembly, 1-3 

Recursive macro calls, 3-16, 4-20 
Redefinition of macros, 4-18 
Redefinition of symbols, 2-8, 

2-19 

Referencing the location counter, 
2-14 

Relocatable programs, 1-1, 1-3, 
5-19 

Relocation mode, 3-7 
Repeat object code pseudo- 
operation, 3-26 
. REPT pseudo-op, 3-26 
Requesting an I/O device handler 
pseudo-operations, 3-26 
Request program size pseudo- 
operations, 3-28 
Reserving blocks of storage 
pseudo-operations, 3-22 
Restart assembler, 5-21 
RSX system MACRO call, 5-1 
RUBOUT, 5-2 

Running instructions, 5-17 


Segmented source, 5-2 
Segmenting programs, 3-24 
Semicolon ( ; ) used as separator, 
2-1 

.SIXBT pseudo-op, 3-9, 4-3 
Size of program, 3-17 
.SIZE pseudo-op, 3-28 
Slash (/) usage, 2-2, 2-3, 4-3 
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Software, 1-2 
Source listing of the 

absolute binary loader, E-l 
Source, segmented, 5-2 
Space character (i_j) , 2-1 
Spaces in filename, 5-10 
Special symbols, 2-6 
Statement 

delimiters, 2-20, 2-21 
evaluation, 2-24 
fields, 2-17 
format, 2-1 
line length, 2-1 
terminator, 2-24 
Statement, direct assignment, 
2-3 

Storage words, 2-13 
Subtraction operator, 2-12 
Symbol 

definition, 2-4 
evaluation, 2-4, 2-29 
redefinition, 2-8, 2-19 
Symbolic address pseudo- 
operation, 3-26 
Symbolic label, 2-17, 2-18 
Symbols, 2-3 
created, 4-7 
special, 2-6 
undefined, 2-10 
Symbol table output, 5-14 
Symbol tables, 2-4 


Undefined symbols, 2-10, 5-20 
User's Symbol, 3-26 
table, 2-4 


Validity bits, 2-28 
Variables, 2-7, 5-20 
VT15 processor, 3-8 


Word evaluation, 2-25, 2-28 


X option, 5-18 
X used as symbol, 2-6, 2-13 


Zero, division by, 2^12 
Zeroing a storage location, 2 


Tab character ( -»| ) , 2-1 
Tag, 2-2 

field, 2-1 
symbol, 3-26 

Terminators, command string, 

5-3 

Text delimiter, 3-9 
Text handling pseudo-operations, 
3-8 

.TITLE pseudo-op, 3-3 
Transfer vector, 1-3, 3-12 
Trimmed six-bit format, 3-9 
Two's complement, 2-12 


Index-4 



Please cut along this line. 


MACRO XVM Assembler Language Manual 
DEC-XV-LMALA-A-D 


READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 

with software should be reported on a Software 
Problem Report (SPR) form. 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 

■ | Assembly language programmer 

|-| Higher-level language programmer 

! | Occasional programmer (experienced) 

; | User with little programming experience 
I | Student programmer 

I | Non-programmer interested in computer concepts and capabilities 

Name Date 

Organization 

Street 

City State Zip Code 

or 

Country 

If you require a written reply, please check here. □ 



Fold Here 


Do INol Tear - Fold Here and Staple 


FIRST Cl ASS 
PERMIT NO. 33 
MAYNARD. MASS. 


BUSINESS REPLY MAIL 

NO POSTAGE STAMP NECESSARY IF MAILED IN I HE UNITED STATES 


Postage will be paid by: 


SBIDDSD 


Software Communications 
P . 0 . Box F 

Maynard, Massachusetts 01754 




mm 


digital equipment corporation 


PRINTED IN U.S.A. 




